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PREFACE 


This publication describes the internal logic of the DOS Emulator program, 
which runs under the contrcl of the Operating System on IBM System/370 Models 
135, 145, and 155. DOS emulation is a combination of the DOS Emulator program 
and the System/370 DOS Compatibility Feature. 


The relationship of the program logic to the logic of the DOS Compatibility 
Feature is discussed. 


DOS emulation enables DOS problem programs to run under control of OS without 
program conversion. The COS Emulator program executes as an OS preblem program 
under a nonzero storage protecticn kev. 


This publication is intended for use by persons involved in vorogram maintenance, 
and system programmers who are altering the progran design. 


HOW TO USE THIS PUBLICATION 


This program logic manual surrlements the DOS Emulator program listing. The 
same labels are used on the PLM flowcharts, on the program listing, and within 
the module descrirtions. 

Effective use of this publication requires an understanding of the: 

° Organization of the publication as a whcle 


@ Organization of the DOS Emulator program into major operations 


e Use of the Emulator mcdule directory as a key for locating items relate. 
to each module 


e Prerequisite and related publications 


° Notational conventions used to describe the syntax (or format) of control 
statements 


These topics are discussed below. 


Organization of the Publication 


In addition to the preface, a table of contents, a list of figures, and a list 
of abbreviations used in this manual, this publication has these major parts: 


® "Summary of Changes," which summarizes the major technical changes reflected 
for version 2, level 1 and version 2, level 0. 


° "Tntroduction," which briefly describes the capabilities of the DOS Emulator 
program, program linkages, and the interaction between the Emulator and 
OS. 

e "Method of Operation," which describes the internal logic of the DOS 


Emulator pregram and the function of each routine. 
° "Program Organization," which consists of the flowcharts for each routine 


and a summary of the function(s) of each module. (The summary always 
appears on the page preceding the first flowchart for the module.) 
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e "Directories," which lists the Emulator program labels alphabetically with 
their flowchart identifications and the section of the manual in which 
each label is discussed. In addition, there is a module directory, which 
can be used to locate key items about each module, a data area directory 
with information about each data area, lists of Emulator macros and field 
names. 


e "Data Areas," which gives detailed layouts of control blocks, tables, and 
words to help identify information in storage dumps. 


e "Diagnostic Aids," which gives debugging hints, Emulator dependencies on 
OS, DOS, and hardware, general register assignments, Emulator service aids, 
and message-to-module relationships. 


° "Appendix," which describes the functions and formats of the two hardware 
instructions and associated lists used by the DOS Compatibility Feature. 


e "Glossary," which defines new terms and, for quick recall, some terms 
defined in prerequisite reading. 


e "Index," which is a subject index to this publication. 


Organization into Categories 


DOS Emulator program operations, defined in the first part of the "Method of 
Operation" section, fall into the following categories; initialization, 
synchronous interruptions, asynchronous interruptions, direct-accsss volume 
sharing, abnormal end conditions, and service aids. 


The second part of the "Method of Operation" section (module descriptions) 


and "Program Organizaticn" section (module summaries and flowcharts) are 
arranged in the same sequence for easy cross-reference, 


Use of the Emulator Module Directory 


The Emulator module directory in the "Directories" section can be used to find 
the location of the verbal descrirtion of each Emulator module, the flowchart (s) 
for each module, the summary of each module's functions, and other key 
information ccncerning that module. 


Prerequisite and Related Literature 


Effective use of this PLM requires a familiarity with DOS and an understanding 
of both the IBM System/370 Models 135, 145, and 155 and OS. A working knowledge 
of System/370 status switching, interruption mechanism, and input/output 
operations is also helpful. The following publications provide necessary 
background information or are referenced in the text: 

Concepts and Facilities for DOS and TOS, GC24-5030 

DOS IPL and Job Contrcel Prcgrams, Program Logic Manual, GY24-5086 


DOS Logical I0CS, Volume 3: Sequential and Direct Access CASD Files, GY24- 
5088 


DOS Logical Transient Programs, GY24-5152 
DOS Supervisor and Physical Transients, GY24-5151 
DOS System Programmer's Guide, GC24-5073 
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Emulating DOS Under OS on IBM System/370, GC26-3777 

IBM System/360 and System/370 SRL Newsletter, GN20-0360 
IBM System/360 Principles of Operation, GA22-6821 

IBM System/370 Principles of Operation, GA22-7000 

OS Data Management for System Programmers, GC28-6550 

OS Data Management Macro Instructions, GC26-3794 

OS JCL Reference, GC28-6704 

OS Master Index to Logic Manuals, GY28-6717 

OS Storage Estimates, GC28-6551 

OS Supervisor Services and Macro Instructions, GC28-6646 


OS System Control Blocks, GC28-6628 


OS/VS Data Management Macro Instructions, GC26-3793 
OS/VS Data Management for System Programmers, GC28-0631 
OS/VS JCL Reference, GC28-0618 

OS/VS Master Index of Logic, GY28-0603 

OS/VS Supervisor Services and Macros, GC27-6979 

OS/VS1_ Storage Estimates, GC24-5094 


OS/VS1_ Svstem Data Areas, SY28-0605 


Notational Conventions 


A uniform system of notation is used to describe the syntax (or format) of 
utility control statements. This notation describes which parameters are 
required and which are optional, the options available in expressing values, 
and the required punctuation. 


Capital Letter Type 


In the notation, capital letter type (LIST) is used to indicate specific values 
that must be coded exactly as shown. 


Punctuation 


The period (.), comma (,), semicolon (3), equal sign (=), and apostrophe {(') 
are used for punctuation and must be coded as shown. These punctuation marks 
serve to separate the parameters of a utility control statement. 
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Brackets 
Brackets ({ ]) indicate that the elements and punctuation they enclose are 
optional. The brackets themselves are for descriptive purposes only, and are J 


not to be coded. For instance 

value=element1,element2,element3[ ,element4] 
indicates that "value=" must be fcllowed by three required parameters (element, 
element2, and element3) separated by commas. As indicated by the brackets, 
element4 is optional and need not be coded. Tf element4 is coded, however, 
the comma that immediately precedes it must also be coded. 


When choices are available for an optional value, the choices appear in 
brackets, one choice above another, as follows: 


value=element0[ ,elementl ] 
[,element2 ] 
{,element3] 


in the above example, "value=" must be followed by element0O. Optionally, 
element1, element2, or element3 can be coded. 


Braces 
Braces ({}) indicate a required choice. The kraces themselves are for 
descriptive purfoses only and are not to be coded. For example: 


value= {element 1} 


{element 2} ) 
indicates that "value=" must ke fcllowed hy either element1 or element2. 


Underscoring 


Underscoring indicates a default value -- a value assumed by the program if 
no value is coded. For example, given that no optional value is coded in the 
following: 


value=[ element 1] 
[element2 ] 


Flement1 is assumed. 


Ellipsis 


An ellipsis (...) is used to indicate that one or more additional parameters 

or sets of parameters, each identically fcrmatted, optionally can be added 

to the operand. For example, given the following: 
value=element1,element2... 


the ellipsis indicates that everything preceding the ellipsis and following 
the equal sign can be repeated. 
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SUMMARY OF CHANGES FOR VERSION 2, LEVEL 1 


New Programming Support 


e Release 27 of DOS is supported. 


e The DOS residence file (SYSRES) can be shared (two or more Emulators may 
share the residence file). 


e The DOS residence volume can be shared (OS data sets may reside on the 
DOS residence volume). 


° The Emulator service aids provide a new debug command (DTAG) that causes 
a diagnostic message to be pnrinted when the DOS program restriction 
(modifying CCWs after an I/O request and before I/O completing) is violated. 


The service aids also provide a new TRACE command parameter (NOWRAP) that 
causes the trace table to be dumped each time it is full. 


New Device Support 


The Emulator now supports the following IBM devices: 
° the 3420 Maqnetic Tape unit 

e the 3230 Disk Storage 

° the 3505 Card Reader 


e the 3525 Card Punch 
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SUMMARY OF CHANGES FOR VERSION 2, LEVEL 0 


Direct-Access Volume Sharing 


With the removal of the Version 1 requirement for private volumes, DOS and 

OS data sets can now reside on the same DASD volume. Use of this function 

is optional for one or more volumes in an Emulator job step. The DOS systems 
residence volume cannot be shared. 


ISAM Compatibility 


Unmodified DOS programs running under the Emulator can access OS format indexed 
sequential data sets. By changing their DOS indexed sequential files to OS 
format, Emulator users can process them using either their old DOS programs 

or newly-written OS programs. 


BTAM Su p port i 


The "=mulator supports DOS BTAM and permits the use of the HIO instruction for 
BTAM only. 


Tmproved Initialization 


Optionally available are an automatic DOS IPL and abbreviated emulator prompt. 
Use of these can speed up and sSimplifv the operator action required when an 
emulation partition is initiated. 


Improved Printer Support 


Tf the format of printed output is such that the standard forms tape does not 
apply, the operator may change format. A new subparameter is provided in the 
DD statement to call a carriage tape image from the OS image librarv. This 
image specifies the physical carriage tave to be mounted on an IBM 1403 Printer. 


Service Aids 


The Emulator optionally provides routines for use as an aid to debugging. 
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ABBREVIATIONS USED IN THIS BOCK 
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Note that field names of data areas created, modified cr interrogated by the 
Emulator ("Field Name Takkle") and symbolic routine names ("Emulator Module 


Directory") appear in the "Directories" section. 


abn - abnormal 

ACCW list - adjust CCW list 

ADCONS - address constants 

ADDR - address 

AJF - adjustment factor 

ASYN - asynchronous interruption address 
async. - asynchronous 

ASYNEXIT - user asynchroncus routine name 
ATTN - attention 


BDDD - base/displacement 

BEBLK - begirning and end block 

BG - background (DOS partition) 

BISAM - basic indexed sequential access method 
BLP - bypass lakel processing 

BOF - beginning of file 

BSAM - basic sequential access method 

BTAM - basic telecommunications access method 
BTR - DOS B-transient phase 


c - character 

CAW - charnel address word 
cc - condition code 

CCB - command control block 
cchh - cylinder/head 

ce - channel end 


CcW - channel command word (also, in listings, CCW address) 


COMP - compare 

COMREG - communications region (DOS) 
COMTAB - communications table 

cond. - conditions 

CPU - central processing unit 

CRnn - register contents compare 
CSECT - control section 

CSW - channel status word 

CTEXT - COMTAB extension 

cuu - channel and unit 


DA - direct access 

DADSM - direct-access device space management 
CASD - direct-access storage device 

DCB - data control block 

DD - data definition 

DEB - data extent block 

[TECB - data event control blceck 

DIAG block - diagnostic block 

DLBL - DASD label 

DOS - disk operating system 


DOSCOM - DOS communication region (see also COMREG) 


DOSLOG - DOS system log 
DRILIST - local execution list 
DSCB - data set control block 
DSECT - dummy section 

DSN - data set name 

DTF - define the file 

DTFDA - DTF direct access 
DTFIS - DTF ISAM 

DTFPH ~ DTF physical 

DIFSD - DTF sequential disk 
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EBCDIC - extended binary coded decimal interchange code 
ECB - event cecntrol block 

EMBLKS - Emulator and I/O control blocks 

EMU - Emulator region ) 
EMUCONS - Emulator constants area 

EOF - end of file 

FOV - end of volume 

FOX - end of extent 

ERP - error recovery procedure 

EXCP - execute channel rrcgram 

EXT - external 


F ~ format (used in context with DSCB); foreground (used in context with 
DOS partitions; also PTB) 

FCB - forms ccntrcl buffer 

FDAD - full direct-access address 

FICL - first in class 

FID - file ID 

FIDBLK - file ID block 


hex - hexadecimal 
HIO - halt I/O 


ID - identification 

Init - initialization 

Int. - interrupt 

T/O - input/output 

IOB - I/O block 

Tocs - I/O centrol system 

IPL - initial program loader 

IPSW - PSW at interrupt 

IS - indexed sequential 

ISAM - indexed sequential access method 


ISBLK - ISAM block 
ISFMS - indexed sequential file management system \ 
ISK - insert storage key 


JcL - job control language 
JFCB - job file ccntrcel block 


KEY - storage protection key 


LCTL - load contrel 
LDMD - DOS load module 
BX list - local execution list 
LIOCcS - logical I/O control system 
LMAD - limit address 
LOGIOB - constants and pointers associated with DOS system log 
LPSW - load PSW 
LTK - logical transient key 
LUB - logical unit block 


MFT multiprogramming with a fixed number of tasks 
MOD module name 
MVT - multiprogramming with a variable number of tasks 


n ~ decimal number 

N/A - not applicable 

NICL - number in class 

NODOS - DOS storage area omitted 
NOP - no operation 


opcode - operation code 
OP/OPCD - CCW operation code 


OPR - operation rfeinter 
OS - operating system j 
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Pp - page number 

PC - program check (also, in listings, program interruption address) 
PCEXIT - user PC exit routine name 

PCIL - private core image library 

PIB - program information block 

PIK - program interrupt key 

PRPGM - problem program 

PSW - program status word 

PUB - physical unit block 


OQISAM - queued indexed sequential access method 
QSAM - queued sequential access method 


R - register 

RC - return code 

RCCWLIST - adjust CCW data address list 
Rnn - register number 

RPSW - resume PSW 

RTN - routine 


SCK - set clock 

SD - sequential disk 

SEEK - seek address for DASD 

shar. - sharing 

SIDE - search ID equal 

SIO - start TI/0 

SKE - search key equal 

SLI - suppression of possible incorrect length indication 

SNS - IOB sense bytes 

SSK - set storage key 

SSM - set system mask 

STCTL - store control 

STGCON - constants and pointers associated with staged devices 

STIDC ~- store channel ID 

STIDP - store CPU ID 

SVC - supervisor call (also, in listings, SVC interruption address) 

SVCEXIT - user SVC exit rcutine name 

sync. - synchronous 

SYSEMcuu - an Emulator DDname (SYSEM) associated with a 
DOS channel and unit number (cuy) 

SYSLOG - DOS syster log 

SYSREC - system recorder file 


t - time (hour, minute, second) 
TBL - table 

TCB - task ccntrol block 

TCH - test channel 

TCU - terminal control unit 
TEB - tape error block 

TEBV - tape error ky volume 
TIC - transfer in channel (also, in listings, TIC address) 
TIO - test I/0 

TIOT - task input/output table 
TRKPAL - track kalance 


UCB - unit ccntrol block 
UCS - universal character set 


VOL - volume 

VS - virtual storage 

vVToc - volume table of contents 
WLR - wrong length record 


X - hexadeciral 
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INTRODUCTION 


The DOS Emulator program, IIVEMU, executes as a problem program under 9S with 
an MFT, MVT, or VS1 contrcel program. The DOS Emulator program (hereafter 
called the Emulator) works in conjunction with the DOS Compatibility Feature. 
The functional result is that DOS and DOS problem programs are able to execute 
successfully under control of the Operating System. 


DOS EMULATION 


DOS emulation is a combination of programming techniques and special machine 
features that permit DOS tc operate under OS. The Emulator and, subsequently, 
DOS are loaded into an OS partiticn or region. When the Emulator or OS programs 
are in control of the CPU, the system is said to be in normal mode, that is, 
operating with true main-storage addresses. 


When DOS programs are executing, the system is in local execution mode, that 
is, by means of a microrprcgram and/or hardware, DOS or lccal addresses are 
automatically adjusted to program addresses. When DOS is given control by 

the Emulator, the DOS Compatibility Feature effects the changeover to local 
execution mode. It does this by adding an adjustment factor (beginning address 
of DOS) to all addresses contained in each instruction as that instruction 

is processed (except for instructions that address channels and units). DOS 
and its problem programs execute in this rode unaided by the Emulator until 

a hardware interruption occurs. 


Since DOS operates in local execution mode, supervisor calls and program 
interruptions must be intercepted by the DOS Compatibility Feature (a detailed 
discussion of this feature is in the Appendix) in order to bypass the OS 
interruption-handling mechanism. 


In addition to interruption handling, DOS emulation performs most of the 
functions normally performed by hardware. I/0 operations car.not be performed 
by DOS emulation and are accomplished by use of OS macros and data management 
services. Asynchronous interruptions (I/0, external, and machine check) are 
handled by OS in the usual manner except that control is returned to the 
Emulator before passing back to DOS. (See “Interruption Action tthen CPU is 
in Local Execution Mode" fcr more details.) 


ENVIRONMENTAL CHARACTERISTICS 


The Emulator is loaded into an OS partition or region (hereafter called the 
Emulator region). One of the Emulator's initializaticn routines (IIVGET) 
issues the GETMAIN macro instruction to oktain space within its region for 
DOS and for Emulator and OS control blocks to be used in I/O operations. 


DOS is subsequently loaded into the Emulator region, beginning at a 4K boundary. 
The Emulator and OS control blocks occupy available space between the Emulator 
and DOS and/or between DOS and the end of the region. Figure 1 shows the 
Emulator's main-storage environment after DOS has keen loaded. 


Tntroduction 1 


At a minimum, the Disk Operating System consists of a DOS supervisor and a 
background partition (BG). The two optional foreground partitions (F1 and 
F2) are shown in Figure 1. 
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Figure 1. The Emulator's Main-Storage Environment 


RESOURCE REQUIREMENTS 


"Resource" is defined here as any input/output device, volume, or data set 

required by the Emulator. A resource may be dedicated, staged, or shared. 

If a resource is dedicated, it is reserved for the duration of an Fmulator 

job step. If a resource is staged, input/output is placed in the OS input 

or output stream. If it is shared, OS job steps executing concurrently may 
access it. 


There are three types of input/output devices: unit record, tape, and direct 
access. The DD statements for a DOS emulation run can specify whether a unit- 
record device is to be dedicated or whether its input/output is to be staged. 
A tape device by its very nature must be dedicated to the processing job. 

A direct-access device cannot be dedicated as such to an Emulator job. It 

is evident, however, that if a private volume is mounted on a direct-access 
device, the device is, in effect, dedicated to that volume. Direct-access 
volumes and data sets may be shared with other processing jobs, or data sets 
may be dedicated to an Emulator jobstep. 


In terms of access method techniques and data set formats, private volumes 

must be requested in DD statements for a DOS emulation run involving DOS indexed 
sequential files since they have a different format from OS indexed sequential 
data sets and are unrecognizable to the OS indexed sequential access method. 


OS ISAM volumes can be shared with other OS regions, but OS indexed sequential 
data sets should be shared for read only type operations. 


OS sequential DASD and direct-access data sets and DOS Sequential DASD and 
direct-access files are compatible, so they may be shared by more than one 
OS region for read only type operations. 


To sum up, the DD statements for a DOS emulation run can specify: 


e A group of OS devices to be dedicated for the duration of an Emulator 
jobstep, 


@ Volumes to be dedicated for the duration of an Emulator jobstep, 


e Volumes that can be accessed by concurrent OS jobsteps, 
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e Files (data sets) to be dedicated for the duration of an Emulator jobstep, 
e Files (data sets) that can be accessed by concurrent OS jobsteps, or 


e DOS I/O requests for DOS unit record devices to be staged (spooled) into 
the OS I/O stream. 


Dedicated Resources 


Unit-record and tape devices. Where a dedicated device is of the same type 
as that used by DOS in its stand-alone environment, COMTAB (communications 
table) maps (assigns an OS device for each DOS device specified in a DD 
statement) the DOS device address to a corresponding, but not necessarily the 
same, OS device address. In most instances, identical device types are 
required, but some exceptions are: 


Unit Specified on DD Statement Unit Allowed in PUB Table 
3211 14030 
3420 2400 
3505 2540R 
3525 2540P 


In the example 
//SYSEM180 DD UNIT=2400, data set parameters 


COMTAB associates the DOS device address 180 with the address of the device 
that was allocated to the Emulator job. If the absolute unit address, such 

as UNIT=282 were coded, OS would assign the device at that address, if it were 
available. 


Direct-access volumes. OS can be prevented from allocating temporary data 

sets on a DOS Emulator volume if the volume is defined as private in the PRESRES 
member of the library SYS1.PARMLIB, or the volume is offline until OS allocates 
it for the Emulator, and a DD statement in the following format is specified: 


//SYSEM190 DD VOL= (PRIVATE, SER=111111) , UNTT=2311, DISP= {OLD} 
{SHR} 


where 111111 is the volume serial number of a private pack mounted on an IBM 
2311 Disk Storage Drive. Because of the absence of the DSN parameter, this 
statement allows DOS access to any valid address on the entire volume by means 
of the Emulator end-of-extent appendage. See the module description for 
IGGQ19SA for further details. 


Other DOS Emulators are prevented from using Space on that volume by the use 
of ENQ and DEQ macro instructions. Other OS regions are unable to access or 
create any data sets on that volume, unless that volume is svecifically 
requested in the VOL parameter of a DD statement. 


Note: Two or more DCBs should never be opened cOncurrently for output to the 
same data set on a direct-access device. If exclusive control of the data 
set is not maintained and another DCB is opened before the current DCB is 
closed, the updated records can become permanently inaccessible. 


DASD data sets. DASD data sets can be made private when the DISP parameter 
is coded as shown in this example: 
{OLD} 


//SYSEM190 DD VOL=SER=222222,UNIT=2311,DSN=A, DISP= {NEW} 
{MOD} 


Introduction 3 


In the above example, if data set A were on a volume with multiple data sets, 
it would be the only data set on that volume inaccessible to other OS regions. 
The ‘DISP parameter does not apply to DOS indexed sequential files because these 
files must always be processed on a private volume. 


Staged Resources 


Unit-record devices need not be dedicated to DOS emulation. Instead, a DOS 
emulation jobstream can request the use of the OS input stream and/or the use 
of the OS output stream. To take advantage of the former option, DOS program 
input is inserted between a //SYSEMcuu DD DATA card and a /* card in the DOS 
emulation jobstream. (The channel and unit (cuu) must represent a DOS PUB 
(physical unit block) table entry associated with a card reader assignment. 
The result of staging DOS input is that the OS reader/interpreter spools DOS 
program input to a DASD from which it can later be read. 


DOS output can be staged if this card is inserted in the DOS emulation 
jobstream: 


//SYSEMcuu DD SYSOUT=output class 


(The cuu must represent a DOS PUB table entry associated with a card punch 
or printer assignment, and SYSOUT must indicate an output class.) OS will 
then provide the following services: 


e When the Emulator is initiated, space will be reserved for DOS program 
output on a DASD. 


° After DOS processing has ended, the output will be transcribed by a SYSOUT 
writer to an appropriate output device. 


Shared Resources 


In addition to being able to designate private volumes (discussed in "Dedicated 
Resources"), the Emulator is able to designate public volumes, to dedicate 

data sets to a particular DOS emulation run (also discussed in "Dedicated 
Resources") and to share data sets with other OS regions. 


Since unit record and tape devices cannot be shared, this section will discuss 
only direct-access devices and, more specifically, DASD volumes and data sets. 
The discussion will not include DOS indexed sequential files, which must be 
processed on private volumes. 


Both OS and DOS data sets can reside on the same volume. During emulation, 
OS performs data-set spac2 allocation and DOS is prevented from performing 
space allocation. A data set, with the exception of OS indexed sequential 
data sets, must reside on one volume. 


Figure 2 shows the Emulator methods of accessing DASD data sets. If a volume 
is not shared, the program may access any OS sequential DASD or direct-access 
data set, any DOS sequential DASD or direct-access file, or any DOS indexed 
sequential file. If a volume is shared, the Emulator program takes one of 
two paths. If an OS sequential DASD or direct-access data set or a DOS 
sequential DASD or direct-access file is being accessed, it is routed through 
Emulator module IIVDVS; if an OS indexed sequential data set, it is routed 
through Emulator module IIvis. (For more details, see "Direct-Access Volume 
Sharing.") 
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Figure 2. Methods of Accessing DASD Data Sets 


OS direct-access and sequential DASD data sets and DOS direct-access and 
sequential DASD files. One DD statement must be provided for each data set 
or file on a shared volume. The DD statement must include a nontemporary data 
set name (dsname). The first DD statement must indicate the cuu contained 

in the DOS PUB table for that data set. Subsequent DD statements describe 
other data sets located on the volume defined by the first DD statement. DOS 
control statements (such as DLBL, EXTENT, and ASSGN) are still required for 
these files, but the extent information in the EXTENT statement need not be 
valid (however, it must be syntactically correct) since the Emulator overrides 
this information with the extents supplied by OSs. 


Typical DD statements for specific volumes are: 


//SYSEM132 DD DSNAME=DOS. FILE.IDA, UNIT=2314, VOL=SER=123456 
//anything DD DSNAME=DOS. FILE. IDB, UNIT=2314, VOL=REF=*. SYSEM132 


Typical DD statements for nonspecific volumes are: 


//SYSEM132 DD DSNAME=DOS. FILE.IDA, UNIT=2314, DISP= (NEW, DELETE) , SPACE=(CYL, (4, 2)) 
//anything DD DSNAME=DOS. FILE.IDB, UNIT=2314, VOL=REF=*. SYSEM132, 
DISP= (NEW, DELETE) , SPACE= (TRK, (10, 3)) 


Note that DSNAME= must be followed by the name of the data set which must be 
the same name as coded in the file ID field of the DLBL statement. In addition, 
if DISP=SHR is coded, data sets may be shared. (If a data set is shared with 
another OS task, both tasks can read only.) 
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If two or more data sets on the same volume are used ina job step (see last 
example), the SYSEM ddname must be coded for the first data set; thereafter, 
a unique ddname not beginning with SYSEM must be coded for subsequent data 
sets. The DD statements are tied together when they specify the same volume 
serial number, when the SYSEM ddname is referred to, or when a SYSEM ddname 
with a nonspecific volume request is referred to. 


OS_ indexed sequential data sets. The Emulator allows DOS problem programs 
to create and access OS indexed sequential data sets through OS indexed 
sequential access methods. (See "File Requirements" for a possible 


The OS volume(s) on which an OS indexed sequential data set resides is described 
to the Emulator by the SYSEMcuu DD statement for the volume. The dsname is 

used to map to the proper OS data set by means of the Emulator ISAM mapping 
routine (IIVIS). The same DOS control statements mentioned in the discussion 
of direct-access and sequential DASD data sets are also required for OS indexed 
sequential data sets. 


Typical DD statements for specific volumes for indexed sequential data sets 
are: 


//SYSEM132 DD DSN=DOS.ISAM. FILEA (INDEX) , UNIT=2314,DISP=NEW, 


// VOL=SER=111111, DCB=DSORG=IS, SPACE= (CYL, 2) 

// DD DSN=DOS. ISAM. FILEA (PRIME) , UNIT=2314, 

// VOL=SER=222222, DCB=*. SYSEM132, SPACE= (CYL, 20) 
//SYSEM133 DD DSN=DOS.ISAM. FILEB, UNIT=2314, DISP=OLD, 

// VOL=SER= 333333, DCB=DSORG=IS 

//anything DD DSN=DOS.ISAM. FILEC, UNIT=2314,DISP=OLD, 

// VOL=REF=*. SYSEM133, DCB=DSORG=IS 


Typical DD statements for nonspecific volumes for indexed sequential 
data sets are: 


//SYSEM132 DD DSN=DOS.ISAM.FILEA (INDEX) ,UNIT=2314, 


// DISP=NEW, DC B=DSORG=IS, SPACE= (CYL, 2) 
// DD DSN=DOS. ISAM. FILEA(PRIME) , UNIT=2314, 
// DC B=DSORG=1S, SPACE= (CYL, 20) 


//anything DD DSN=DOS.ISAM.FILEB, UNIT=2314,DISP=OLD, 
VOL=REF=*. SYSEM132, DCB=DSORG=IS 


EMULATOR/OS INTERACTION 


This section discusses parts of OS that are used by the Emulator. 


OS Macros 


The Emulator communicates its service requests to OS with the OS macros listed 
in "Diagnostic Aids." 


Emulator Appendages 


To circumvent certain automatic functions and restrictions imposed by OS (see 
the module descriptions for IGG019SA and IGG019S1 for more details), two 
input/output appendages are required by the Emulator. Both appendages operate 
in the supervisor state under a protection key of 0. These modules 
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in the supervisor state under a protection key of 0. These modules 
automatically gain control at the appropriate time if the last 2 characters 
of their 8-character names are specified in the DCB macro instruction. 


Requesting Bypass Lakel Processing (BLP) 


The OS open routine, which is called when the Emulator issues an OPEN macro, 
must not process DOS tape labels. (DOS does its own label processing.) To 
prevent OS from processing DOS labels, BLP must be coded in the LABEL parameter 
of every DD card for a DOS tape volume. The OS Open routine will then find 
that the BLP bit is cn in every JFCB for tape volumes, and it will bypass label 
processing. 


Note: JFCBs are built by the OS reader/interpreter. All IBM reader procedures 
specify that the reader/interrreter is to ignore BLP if it is encountered on 

a DD card. Consequently, the BLP bit will not be on in a tape JFCB unless 

the user has modified the IBM reader procedure or written his own. 


OPERATIONAL CCNSICERATIONS 


Staged Output Considerations 


The staged output of DOS jobs in a given emulation run is transcribed from 

a DASD to a printer or punch not piecemeal, but all at once, after the emulation 
run has terminated. Enough space to receive the combined output cf the emulated 
DOS jobs should ke reserved on the CASD. If more space than the system's 
default is needed, the SPACE parameter can be coded on the appropriate On 
statements. The Emulator job is abnormally terminated if insufficient space 

is allotted. 


Printer Overflow Simulation 


DOS receives no indication that staged output to a printer is really output 

to a DASD with a later transcription to an OS printer. The Fmulator, therefore, 
must simulate printer overflow indications when DOS output is staged to a 
printer. 


The user may specify the length and format of the physical forms-control tape 
that will be mounted cn nonFCE printers, such as the 1403, at the time the 
system output writer transcribes the hard copy to the printer. To do so, the 
user must allocate and catalog the image as a member of SYS1.IMAGELIB. The 
user forms-ccntrol image must be assembled and link-edited into SYS1.TMAGELI8 
before executing the Emulator. See the SETPRT macro in Data Management for 
System Programmers for OS or OS/VS for details. 


The Emulator creates a forms-ccntrcl image from the OS 3211 FCB image. If 
the DD statement FCB parameter is not specified, the Emulator standard forms- 
control image arrlies. 


Additionally, a DOS dynamic load of the FCB will override user specifications. 
Special commands other than READ FCB and LOAC FCB will ke rejected. 


The printer overflow default image describes a standard-size vage of 66 lines. 


The image is formatted with five lines of space at the top and bottom and 12 
channels in ketween, distributed four lines apart. If, for a nonFCB printer, 
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a printer overflow indication is required by a DOS problem program, the phvsical 
carriage tape should conform to this format or the printed results will be 
unpredictable. 


Emulator Separator Feature 


The user may stage the output of a Disk Operating System being emulated that 
has more than cne printer or card punch assigned to it by coding a DD statement 
for each DOS printer or punch assignment for which output will be staged. 

For example: 


//SYSEMOOE DD SYSOUT=A 
//SYSEM01E DD SYSOUT=A 
//SYSEMCOD DD SYSOUT=B 
//SYSEM01D DD SYSOUT=B 


The Emulator's separator feature writes three separator cards before the punched 
output in each stacker of each staged funch and a separator page before the 
printed output of each staged printer. At the top of a separator page is the 
message: 


TIV275I SYSEMcuu 
where cuu identifies the channel and unit of the DOS staged printer. 
Each separator card is punched in the following format: 


Columns 1-34 hexadecimal FFs (12-11-0-7-8-9 punches) 

Columns 35-36 blanks 

Columns 37-44 the DOS address of the staged device (SYSEMcuu) 
Columns 45-46 blanks 

Columns 47-80 hexadecimal FFs 


Note: The coding technique shown above for multiple printers and punches is 
also used to stage multiple card readers. 


Data Set Requirements 


DOS indexed sequential files. Only DOS indexed sequential files must be 
converted from DOS to OS format to allow them to be shared with other OS 
regions. Other types of DCS files need not be converted (see "Sequential DASD 
and direct-access data sets"). 


The left side of Figure 3 shows two DOS programs accessing a DOS data set 

before any conversion takes place. Program A is recoded to be run under OS 

(see right) and is now able to access any OS or OS-compatible data set, that 

is, an OS or DOS sequential DASD or direct-access or an OS indexed sequential 
data set. Program B, still in DOS format, may access an OS or OS-compatible 
data set only with the intervention of the Erulator. The DOS file may also 

be converted to OS format; in fact, a DOS indexed sequential file must he 
converted to allow OS and DOS volume sharing. If DOS indexed sequential files 
are changed to OS format, they can be processed by either their old DOS programs 
or newly-written OS programs. 
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Before conversion After conversion of 
- of program and/or program A and/or 
data set data set 


DOS data set 


OS or OS-compatible 
data set 


Program B 
(DOS) 


Program A 
(OS) 


Program A Program B 
(DOS) (DOS) 


Figure 3. Two Programs Accessing a Data Set Before and After 
conversion 


Note: For more details concerning program and/or data set conversion, see 


OS indexed sequential data sets. The Emulator contains a module (IIVIS) to 
allow a DOS program executing under the Emulator access to an OS indexed 
sequential data set if its logical record format is compatible with the design 
of the DOS problem program. In general, the only limitations on indexed 
sequential data sets relate to OS capabilities that do not exist in DOS. 


An operational consideration when accessing OS DASD data sets with a DOS vrogram 
under the Emulator is that OS optionally supports record deletion and also 

dummy records for formatted fixed-length records with keys. Dummy records 

must be recognized and record deletion handled by the DOS program. 


Sequential DASD and direct-access data sets. Sequential DASD and direct-access 
data sets need not be converted. Module IIVDVS allows a DOS program executing 


under the Emulator to access an OS sequential DASD or direct-access data set 
or DOS sequential DASD or direct-access file on a shared volume. 


The only limitations in a DOS program accessing an OS data set relate to OS 
capabilities that do not exist in DOS. For example, DOS does not maintain 

some identifier (format 1) DSCB data set descriptor fields used by an OS 
sequential DASD data set. For normal OS processing, this information can be 
supplied on the DD statement; however, utility functions such as those performed 
by IEHMOVE iaqnore information supplied in this manner. In addition, DOS FORTRAN 
unformatted records may not be acceptable to OS FORTRAN or data management. 
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Another problem that might be encountered by a DOS direct-access file is that 
nonpreformatted DOS files must be processed as undefined under OS. In addition, 
a DOS user cannot allocate data sets on a DASD (that is, code a physical address 
as a constant) under OS as OS does its own space allocation. (However, phvsical 
addresses mav be used if absolute track allocation is used under OS.) Also, 

the 'M' of "MBBCCHHR! (where M = extent, B = bin, C = cylinder, 41 = head, and 

R = record number) is defined differently in OS and DOS and will be compatible 
only for single-extent volumes. 


BTAM. BTAM operates without change under emulation as a DOS access method, 
using DOS I/O error recovery and statistical recording procedures. Since the 
Emulator runs as an OS job, OS jobs running independently may include OS BTAM. 
Line groups are defined at the DOS level. To OS, each line is a line group 
consisting of one line. One OS DD statement must ke included for each line 
to define the device (line) to the Emulator. The user must define to OS the 
Same type, attributes, and features for the lines, control units, and devices 
that DOS has defined for its corresponding lines. For example, 


//SYSEM068 CD UNIT=069 


relates DOS line 068 to OS line 069. All characteristics of line 069, including 
device type, adapter type, TCU (terminal control unit) type and features, and 
line tvpe, must be the same as those DOS expects for line 068. Lines used 

in the emulated DOS job must ke dedicated to that job. 


PHYSICAL CHARACTERISTICS 


The basic Emulator module (ITVEMU) resides on the system frogram likrary 
(SYS1.LINKLIB) or on a private library containing an overlay structure and 

load modules (see Figure 4). (For further information concerning private 

Data Management for System Programmers, and the JCL Reference, for OS or OS/VS.) 
The overlay structure is composed of a root segment and five overlay segments. 
The root segment is loaded first and given control by OS. IIVINT is the first 
module in the overlay segment to be loaded. When there is need for one of 

the other modules in the overlay segment, it is loaded over IIVINT, and so 

on. 


MAIN-STORAGE REQUIREMENTS 


The minimum MFT or OS/VS1 storage requirement for a DOS emulation run is 23K 
bytes plus the size of the Disk Operating System to be emulated. An additional 
6K bytes are required with an MVT control frogram because of the way MVT storage 
is managed. (Refer to Storage Estimates for OS or OS/VS for OS region 
requirements.) 


Main-storage requirements are further increased by each of the following 
conditions that applies: 


° Tf more than ten devices are used, add 250 bytes for each additional device 
(for I/O tables such as the DCB, IOB, COMTAB entry, etc.). 


Note: Do not include the 96 bytes required for the DCB. This value is 
already accounted for in the 250 bytes specified above. 
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e If a direct-access file other than indexed sequential on a shared device 
is specified, 7.2K bytes are required. This figure includes space for 
up to five files. Add 175 bytes for each file that exceeds five files. 


e If an indexed sequential data set is specified, 6.8K bytes are required 
for the data set (2.4K bytes for volume sharing and 4.4K bytes for ISAM), 
plus 400 kytes for each ADD or LOAD type DTF specified and 625 bytes for 
each RETRVE or ADDRTR type DTF specified. In addition, add the number 
of bytes required for the DCB parameters used for each data set. (See 
Storage Estimates for OS or OS/VS, and the information in Figure 5 to 
determine the number of bytes needed for the DCB parameters used.) 


Number of Bytes Required for Indexed Sequential Data Sets 


Modules for es DCB Parameters Additional 


; Indexed Sequential 
Volume Sharing LOAD | ADDRTR Used Data Sets. 


2.4K + 44K + 400 + 625 + n Bytes + n Bytes 


Number of Bytes Required for Files on a Shared Volume and Indexed Sequential Data Sets 


Additional Additional 
ADD |RETRVE DCB Indexed Files on 


or Parameters Sequential Shared 
Data Sets 


Modules for Modules for Files 
Volume Sharing on Shared volume 


LOAD |ADDRTR 


2.4K + 4.8K + 4.4K + 400 + 625 + nn Bytes + n Bytes + n Bytes 


DTF Type DCB Parameters Used 


MACRFE=PM, RECFM=F or FB, KEYLEN, LRECL (RKP take their 
values from the DTFIS) 


DCB1: 


DCB2: 


RETRVE MACRF=GL, PU, and SK or SI MACRF=RUSC, WUC 
DCB1: DCB2: 
AUDRTE MACRF=GL, PU, and SK or SI MACRF=RUSC, WUAC 
Notes: 
Parameters that do not affect storage requirements have been omitted. 
Two DCBs are used for the RETRVE and ADDRTR DTF types. DCB1 uses QISAM, DCB2 uses BISAM. e 


BLKSIZE takes its value from the DTFIS in all cases. 
BUFNO=2 (the default va!ue) in all cases. 


Figure 5. Storage Estimates for ISAM 
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@ If files on a shared device and indexed sequential data sets are specified, 
7.2K bytes are required for device sharing plus 4.4K bytes for ISAM plus 
the number of bytes needed for DTF type and DCB parameters used. 


e If any DD statement specifies DD DATA, DD *, or DD SYSOUT, add 1850 bytes 


(for the staged I/O routines). 


° For each unique device type defined by a DD DATA, DD *, or DD SYSOUT 


statement, add 256 bytes (for the device command code translate table). 


® If any DD statement specifies DD DATA, DD *, or DD SYSOUT, add the number 


of bytes used by QSAM. This number is variable and depends upon which, 

if any, QOSAM modules are resident in the particular Operating System being 
used. Refer to Storage Estimates for OS or OS/VS, and the information 

in Figure 6 to arrive at this figure. 


° If the service aids are used, 14K should be added to the storage estimates 


for the Fmulator. 


Number of Bytes Required for QSAM Data Sets Used in the Emulator 


DCB Parameters of DCB Parameters of Additional DCB 
Input Stream Output Stream Parameters of |/O Stream 


QSAM Modules of OS 


n Bytes + n Bytes + n Bytes + n Bytes 


OS Stream Used DCB Parameters Used 


OS Input Stream DSORG=PS, RECFM=FB, MACRF=GL 


OS Output Stream DSORG=PS, RECFM=VBA, MACRF=PL 


Notes: 

BUFNO=2 for output. For input, the reader procedure value is used. 

For output, BLKSIZE=9 plus the maximum number of bytes that can be transferred to the unit record device. The 
reader procedure value is used for input. 

Buffering is simple. Scheduling is normal. 


Figure 6. Storage Estimates for QSAM 
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METHOD OF OPERATION 


To become completely familiar with the method of operation of the Fmulator, 
the user of this manual must have a working knowledge of System/370 status 
switching, interruption mechanism, and input/output operations. An 
understanding of the DOS Compatibilitv Feature is also helpful. (See the 
Appendix for a complete description of this feature.) This section describes 
each of the four major operations of the Emulator and each Emulator module. 
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One of the four major operations of the Emulator is to initialize the OS region 

in which it resides. It accomplishes this by verifying parameters given on . 

the DD statements, establishing the DOS storage area, initializing Emulator ? 
tables, and doing an initial program load of DOS. It concludes basic .) 
initialization procedures by passing control to DOS. 


The second major operation of the Emulator is to deal with interruptions that 
occur during operation of DOS programs. These include synchronous (supervisor 
call and program check) and asynchronous (input/output, external, and machine 
check) interruptions. 


The third major operation of the Emulator allows the user additional 
capabilities on an optional basis: 


e Ability of multiple OS regions to concurrently access the same direct- 
access volume. 


e Ability of unmodified DOS programs to access OS-formatted indexed sequential 
data sets. 


The final major operation of the Emulator is to either terminate a job running 
in a given DOS partition or terminate any operations being performed by the 
Emulator, Termination takes place when serious user Or program errors are 
detected. 


These major operations are required (except the third, which is optional) to 
achieve the Emulator's single functional objective, which is to enable DOS 
problem programs to be run on a System/370 under OS. Refer to Figure 23 for 
an overall functional diagram of the Emulator. 


INITIALTZATION 


J 


The Emulator is an OS problem program invoked by OS JCL. It receives control 
at entry point IIVENT. The address of the user parameter area (which contains 
operands from the PARM parameter of the Emulator EXEC statement) is passed 

to the Emulator at this time. Initialization routines verify parameters, 
establish DOS storage, initialize Emulator tables, and perform DOS initial 
program load. 


Figure 7 shows the major steps in initializing the Emulator region and shows 
control pasSSing from one routine to another. (Figure 16 entitled "OS Region 
at Beginning of DOS IPL" shows a map of the Emulator region before 
initialization. Figure 1 entitled "The Emulator's Main-Storage Environment" 
shows a map of the Emulator region after initialization.) 
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Figure 7. IPL of DOS Supervisor During Initialization 
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Verifying Parameters 


The user parameter area is inspected to ensure that all required parameters 
have been specified. The values of the parameters are saved for use @uring 
the initialization operation. If parameter values are missing or invalid, 
the Emulator issies a WTOR to obtain them from the svstem operator. (See 
"Dependence on OS" in the section "Diagnostic Aids" for an exolanation of the 
WTOR macro.) 


Establishing the DOS Storage Area 


The value specified by the DOSSYS parameter vlus a 4%-byte boundary alignment 
factor is used in an OS GETMAIN macro to obtain the storage area into which 

DOS will later be loaded. The starting address is rounded up to the nearest 
4WK-byte boundary and the entire area is initialized to hinary zeros. A FREEMAIN 
is then issued to release the extra 4K bytes at the beginning and end of the 
area. Subsequent GETMAINS obtain parts of this area for Emulator and OS T/0O 
control blocks. 


Initializing Emulator Tables 


The following Emulator tables are built during the initialization operation. 


Communications Table (COMTAB) 


The communications table provides pertinent information about OS and DOS device 
correspondences. (See the section, "Data Areas" for the COMTAR format.) 


One COMTAB entry is created for the DOSLOG system log (NOSLOG) and one for 
each device defined by a DD statement that contains a ddname beginning with 
the characters SYSE. After the table has been created, the entries are sorted 
in ascending order by their DOS channel and unit (cuu) numbers. The starting 
storage address of COMTAB is placed in the Emulator constants area (TIVCON). 


COMTAB Extension 


If a JFCB indicates a shared volume (contains a nontemporary dsname), a COMTAB 
extension entry is temporarily built and chained to the COMTAB entry. This 
temporary COMTAB extension consists of the ddname and dsname. The open flag 
{bit 7 in CTFLAG) and the shared volume flag (bit 1 in CTFLAG3) in COMTAR are 
set to indicate the presence of a temporary COMTAB extension. 


The ddnames in the TIOT that do not begin with the characters SYS (or JOBLIB 

or STEPLIB) are counted; the resulting number is the number of data sets that 
reside on shared direct-access storage devices. The count is used to compute 
the storage needed for the COMTAB extension. 
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ISK/SSK Table 


This table is used to record the keys that would be set by the SSK instruction 
if the BOS problem program were run under stand-alone DOS. When an ISK 
instruction is issued, the Emulator sets the storage key in conformance with 
the way in which it was set by the previous SSK instruction; the Emulator 
obtains the information from this table. This method of simulating storage 
protection does not provide true storage protection, which is provided by 
hardware under normal circumstances. It does, however, allow the DOS supervisor 
to check the location of control blocks to assure that they are in the proper 
task's area. 


ECB Pointer Table 


There is one event control block (ECB) for each DOS device. The ECB is located 
in a COMTAB entry. The Operating System uses this 4-byte control block to 
indicate the completion of an event (such as input, output, or timing) to the 
Emulator. 


This table is a list of addresses of each ECB in the Emulator: one entry for 
a WTOR, one for the operator prompt, one for the timer, and one for each ECB 
contained in COMTAB. 


Post ECB List 


This list contains a 2-byte entry for each completed interruption not yet 
simulated to DOS and, therefore, outstanding to DOS. Each entry consists of 
the byte offset to the associated COMTAB entry and the completion code from 
the ECB. The list is used to ensure that I/O interruptions are simulated to 
DOS on a first-in, first-out basis. 


OS Physical Unit Block (PUB) Table 


The OS PUB table provides a one-to-one correspondence between a DOS device 
(whether dedicated or staged) and its associated OS device. Each 1t-byte entry 
contains a byte offset to the corresponding COMTAB entry. An entry that 
contains X'FF!' indicates the absence of an OS assignment. 


Data Control Block (DCB) 


One DCB iS associated with each dedicated resource, except the DOS system log 
(DOSLOG) device, and one DCB is associated with every data set on a shared 
volume. 


When DOS issues its first I/O request for a dedicated resource, TIIVOPN obtains 
storage area for the DCB, initializes the DCB, and opens the DCB. The storage 
address for the dedicated resource DCB is placed in the corresponding COMTA3 
entry. 


When DOS issues an OPEN for a shared data set, IIVDVS obtains storage area 


for the DCB, initializes the DCB, and opens the DCB. The storage address for 
the shared data set DCB is placed in the corresponding COMTAB extension entry. 
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Input/Output Block (IOB) 


Each COMTAB entry, including the COMTAB entry for DOSLOG, contains an IOB. J 
The IOB is initialized when the DCB is created (see "Data Control Block (DCB)"). 

The format and contents of the IOB varies, depending on whether the device 

is to be staged, is the DOSLOG device, or is neither. 


DOS IPL 


After the first part of initialization has been completed, the DOS IPL phases 
must be read into the DOS main-storage area. The Emulator builds channel 
programs and issues EXCPs to read the DOS bootstrap records into storage. 

The Emulator adjusts the CCW data addresses in the bootstrap records and again 
issues an EXCP. When the DOS bootstrap channel program is successfully 
completed, the DOS IPL phase S$S$A$IPL2 has been read into the DOS area of the 
Emulator region. 


One of the functions of SSASIPL2 is to clear main storage by moving zeros 
throughout main storage until a program interruption (addressing exception) 
occurs. This function cannot be performed in an emulated environment since 
it would destroy Emulator tables and control blocks. To bypass this function, 
the operation code of a move character (MVC) instruction in the clear storage 
loop of $S$ASIPL2 is set to 0. When the DOS phase (SSASIPL2) executes, the 
zeroed operation code causes a program interruption (operation exception) ; 
then the Emulator simulates the expected program interruption (addressing 
exception) to DOS. Control then passes to the DOS IPL routine. 


Passing Control to DOS } 


Control is passed to DOS when the Emulator issues the execute local instruction. 
Conceptually, this instruction is much like an LPSW. (See the Appendix for 
a complete description of the execute local instruction.) 


Before an execute local instruction can be issued for the first time, however, 
a PSW must be built in the first doubleword of the local execution list which 
effectively becomes the current PSW. Only the 3 low-order halfwords of the 

PSW are used by the execute local instruction. The instruction address portion 
of the local execution PSW contains the local (unadjusted) DOS instruction 
address. This address plus the adjustment factor (origin address field in 

the local execution list) points to an area in storage where the next DOS 
instruction to be executed resides. 


When the execute local instruction is executed, the following sequence of 
events occurs: 


e The 3 low-order halfwords of the current PSW are replaced by the 
corresponding fields of the local execution PSW. 


e The contents of registers 14 and 15 are replaced by the third and fourth 
words of the local execution list. 


e The CPU enters local execution mode. 

° The next instruction to be executed is fetched by the CPU from the storage 
location specified by the DOS instruction address plus the adjustment 
factor. 

DOS then retains control until a hardware interruption occurs, at which time 

the CPU leaves local execution mode. 
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INTERRUPTION ACTION WHEN CPU IS IN LOCAL EXECUTION MODE 


The System/370 interruption mechanism, which stores the current PSW as an old 
PSW and fetches a new PSW, functions in a special fashion when the CPU is in 
local execution mode. To follow the machine interruption logic used by 
System/370, refer to Figure 8. 


In general, the current PSW is stored in the first doubleword of the local 
execution list (local execution PSW) and the instruction address portion of 

the current PSW is replaced by one of the three possible interruption addresses 
located in the local execution list (see the "Data Areas" section for the 
format of the local execution list). If the cause of the interruption was 
asynchronous (I/0, external, or machine check), the current PSW is then stored 
as an old (OS) PSW and a new (OS) PSW is fetched. If the cause of the 
interruption was synchronous (SVC or program), the current PSW with the new 
instruction address remains current and the normal interruption mechanism of 
the CPU, and therefore the Operating System, is bypassed. 


Synchronous Interruptions 


Supervisor Call (SVC) Interruptions 


The SVC instruction address field (bytes 28-31) of the local execution list 
contains the address of module IIvsvc. This module automatically gains control 
if an SVC interruption occurs while the CPU is in local execution mode. 


The main function of ITVSVC is to simulate the interruption action normally 
performed by hardware in a stand-alone system. The local execution (DOS 
current) PSW is moved from the local execution list into the DOS SVC old PSW, 
and the DOS SVC new PSW is moved into the local execution PSW. 


When the execute local instruction is eventually issued, the local execution 
PSW becomes the current PSW and the interruption action will have been 
Simulated. Refer to "Passing Control to DOS" and the Appendix for further 
details. 


An additional function of IIvsvc is to check the SVC number for the first SVC 
4 and SVC 14. The first SVC 4 (DOS LOAD) signals that the DOS supervisor is 
in storage and ready to begin processing IPL input. The first SVC 14 (DOS 
EOJ) is assumed to signal the end of DOS IPL and initialization. If an OS 
indexed sequential or an OS or DOS sequential DASD or direct-access data set 
is being accessed, control is passed to module TIVGR2 to monitor the DOS- 
initiated supervisor call interruption. 


Program Interruptions 


The program interruption address field (bytes 32-35) of the local execution 

list contains the address of module IITVPCE. This module automatically gains 
control if a program interruption occurs while the CPU is in local execution 
mode. The different ways in which program interruptions are handled are divided 
into the following categories: 


First program interruption 

Store clock program interruption 
IPL interruption 

Normal program interruption 
Privileged operation 
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Instruction 
Address 


Synchronous (program or SVC) interruptions when the CPU is in local execution mode: 
G) The three low-order halfwords of the current PSW are stored in the jocal execution list. 


(2) Then, depending on the type of interruption, the appropriate address from the local execution list is 
placed in the instruction address portion of the current PSW. 


Current PSW 


at ee 


Local Execution List 


A(IIVSVC) (2) 
Asynchronous Interruption 
Wy 
es 


Instruction 
Address 


System/370 Permanent 


Storage Assignment 
Current PSW 


1/O, External or Machine 
Check New PSW eh 
1/0, External or Machine 
Check Old PSW 


Asynchronous (input/output, external, or machine check) interruptions when the CPU is in local execution mode: 
G) The three low-order halfwords of the current PSW are stored in the local execution list. 


(2) The instruction address portion of the current PSW is replaced by the asynchronous interruption address 
in the local execution list. 


G3) The current PSW is stored in the permanent storage location of the I/O (or external or machine check, 
depending on the type of interruption) old PSW. 


(4) The appropriate new PSW is moved from permanent storage to the current PSW. 


Figure 8. System/370 Machine Interruption Logic 
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First Program Interruption 


The first program interruption the Emulator expects to receive from DOS is 
an operation exception occurring in the Emulator-modified clear storage loop 
in DOS IPL phase $$ASIPL2. 


Store Clock Program Interruption 


The System/370 store clock instruction is executed. The OS clock value is 
then adjusted by a value which was computed by the set clock routine in module 
ITVPCE. 


IPL Ttnterruption 


The DOSIPL parameter passed to the Emulator in the PARM field of the EXEC 
statement specifies the DOS unit that will contain the DOS IPL statements. 
An I/O interruption from the device specified in the DOSTIPL parameter is 
Simulated to DOS when the Emulator encounters the first PSW with channel 
interruptions enabled and the wait bit set to 1. 


Normal Program Interruption 


Except for the first program interruption, IPL interruptions, and DOS 
Supervisor-initiated privileged operations, the Emulator simulates the action 
of the hardware in a DOS stand-alone svstem by moving the local execution PSW 
to the DOS program old PSW and the DOS program new PSW to the local execution 
PSW. When the execute local instruction is eventually issued, the interruption 
action will have been simulated. 


Privileged Operation 


If the interruption code portion of the local execution PSW indicates that 

the program interruption was caused by a privileged operation exception, the 
local execution PSW is further examined to determine whether the problem program 
bit (bit 15) had been set by the DOS supervisor. If this bit is set to 1 
(problem program state), the program interruption is passed cn to DOS. (See 
"Normal Program Interruption" for details on how this type of interruption 

is handled.) If this bit is set to 0 (supervisor state), the instruction that 
caused the privileged operation exception determines the action taken by the 
Emulator. 


Note: The first halfword of the local execution PSW is ignored by the execute 
local instruction. The contents of the fields within this area are maintained 
only to preserve the continuity of functions either not supported or simulated 
by the Emulator (such as status switching, storage protection, etc.) 


The following privileged operations are simulated by the Emulator: 


e ISK - insert storage key 
e SSK - set storage key 

e SSM - set system mask 

e LPSW - load PSW 

© LCTL - load control 

e STCTL- store control 

e STIDP- store CPU ID 

e STIDC- store channel ID* 
e SCK - set clock* 

e TCH - test channel 

e TIO - test I/0 

e HIO - halt I/0 

e SIO - start I/0 


xThe functions of these instructions are ignored, the condition code is set to 
zero and control is returned to DOS. 
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Privileged instructions RDD, WRD, and DIAGNOSE, and the DOS Compatibility 

Feature instructions (execute local and adjust CCW string) are treated as 

program interruptions. (See "Normal Program Interruption" for procedure.) 

the System/370 privileged instructions (LCTL, STCTL, STIDP, STIDC, SCK) are | 
Simulated only when a DOS Release 27 svstem is being emulated. 


Insert storage key (ISK): The contents of the first operand register of the 
ISK instruction are replaced by the entry in the ISK/SSK table associated with 
the 2K block of storage specified in the second operand. 


Set storage key (SSK): The key specified in the first operand register of 
the SSK instruction replaces the entry in the ISK/SSK table associated with 
the 2K block of storage svecified in the second operand address. 


Set system mask (SSM): The mask located at the storage address specified in 
the operand of the SSM instruction is placed in the first byte of the local 
execution PSW. 


Load program status word (LPSW): The program status word located at the address 
specified in the LPSW instruction is moved into the local execution PSW. An 
additional function of the LPSW simulation subroutine is to intercept the first 
LPSW that specifies a PSW with interruptions enabled and the wait bit set to 

1 during IPL. When this condition is met, an I/O interruption is simulated 

to DOS. (See "IPL Interruption" for procedure.) 


Load control (LCTL): Control register information (starting at the DOS main- 
storage address specified in the LCTL instruction and continuing through as 
many storage words as the number of control registers specified) is moved into 
the control register field labeled CTLREGS in EMUCONS. 


Store control (STCTL): Control register information is moved from the control 

register field labeled CTLREGS in EMUCONS to the DOS main-storage address 

specified by the STCTL instruction and continuing through as many storage words ) 
as the number of control registers specified. ; 


Store CPU ID (STIDP): Eight bytes of CPU identification information are moved 
from a field (labeled CPUID) in EMUCONS to the DOS main-storage address 
specified in the STIDP instruction. The CPIID field in EMUCCNS is initialized 
by the Emulator start I/O appendage. (See "I/O Appendages" in this section.) 


Store channel ID (STIDC): The condition code field of the local execution PSW 
is set to zero (channel ID correctly stored). Control is returned to DOS. 


Set clock (SCK): The resulting values of the difference between the OS time- 
of-day clock and the DOS time-of-day clock is computed and saved in EMUCONS. 
The DOS GETIME routine (SVC 34) is searched for the store clock instruction 
(SCK) and the opcode is set to zero. The condition code field of the local 
execution PSW is set to zero (clock value set). Control is returned to DOS. 


Test channel (TCH): This instruction is simulated when the TCH simulation 
subroutine tests the device-busy flag in COMTAB. All COMTAB entries associated 
with DOS devices on the specified DOS channel are tested. If any of the devices 
are found to be busy, the condition code portion of the local execution PSW 

is set to 2 (channel busy). Otherwise, the condition code is set to 0 (channel 
available). 


Test I/O (TIO): This instruction is simulated when the TIO simulation 


subroutine tests various fields in the COMTAB entry that corresponds to the 
device addressed in the TIO instruction. 
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The 


following TIO condition codes may be set in the local execution PSW and 


passed back to DOS to indicate which of the following conditions exists: 


Cond 


Code 


Halt 


ition 
Meaning 

0 Device not busy 

1 CSW stored (CSW is moved from associated IOB 
into CSW area of DOS storage when I/O is complete) 

2 Device busy (I/O not complete) 

3 Not operational (no COMTAB entry found or CTFLAG, 
nonoperational flag, is set to 1) 

I7O (HIO): The OS macro IOHALT is issued to perform an HIO instruction. 


A condition code of 1 (CSW stored) with a CSW status of 0, is posted to the 


DOS 


Star 
DOS 
os a 
by t 


supervisor, indicating the operation has been halted. 


t I/O (SIO): Because the Emulator executes as an OS problem proaram, a 
request for input or output can be satisfied only with the assistance of 
ata management. How the I/O request is actually handled is determined 
he following criteria: 


If the I/O request is made to the DOS console device (DOSLOG), the request 
is interpreted and reissued in the form of an OS WTO or WTOR (see 1 below). 


If the I/O request is made to a unit-record device that is to be spooled 
from or to a temporary data set, the request is interpreted and reissued 
in the form of an OS GET or PUT (see 2 below). 


For all other I/O requests, the channel command word data addresses are 
adjusted and the request is reissued by means of OS channel programming 


(EXCP) techniques (see 3 below). BS F VW / P U 


I/O operations - DOS system console. The\gnlyj)way a problem program, 
executing under OS, can communicate with the operator is to issue a WTO 
or a WTOR macro instruction by means of module IIVLOG. The parameters 
supplied to these macros will provide the message length, the storage 
address of the message to be issued and, in the case of a WTOR, the reply 
length and storage address. 


IIVLOG gains control at DOS SIO from module TIVPCE. DOS CCWs are located 
and checked for validity. If the CCW command code is for a write, the 
request is reissued as a WTO. If the command code is for a read or for 

a read chained to a write, a WTOR is issued. The WTO or WTOR length 
parameters are modified, as required by the Emulator. Data is moved to 
or from the DOS storage area. 


I/O operations - staged unit-record devices. In a multiprogramming system, 
when the interpreter task of the Operating Svstem encounters a DD * or 

DD DATA statement, a temporary data set is created on a direct-access 
device. Input data that follows the DD statement is spooled (temporarily 
written) to that data set until the /* delimiter is encountered. The data 
for any subsequent input requests iS CWetrieved from the temporary data 


DEM = 


A DD statement specifying a SYSOUT class (for example, DD SYSOUT=A) causes 
OS to create a temporary data set on a DASD. All subsequent output data 
for that class is spooled to that temporary data set. At job termination, 
the data in the temporary data set is routed by the OS system writer to 
the unit-record device specified in the JCL. 


set. 
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Staged I/O receives control at DOS SIO. DOS CCWs are located, checked 
for validity, and interpreted. A QOSAM GET or PUT macro is issued and the 
data is moved to or from the DOS area. Machine control characters (DOS 
CCW command codes) are placed in the output records to cause printer 
skipping and spacing and punch stacker selection. Unit-record device 
operations are simulated to DOS. A CSW and sense byte are maintained for 
each staged device. These indicators simulate unusual device conditions 
such as unit check or incorrect length as well as the usual channel 
end/device end condition. 


If errors are discovered by staged I/O modules in the DOS CAW or in the 
CCW addressed by the CAW, the CSW stored (cCC=01) condition is set in the 
local execution (current) PSW, the CSW is moved into the DOS low storage 
area, and control is returned to DOS. Under all other conditions, the 
DOS SIO condition code is set to 0 (successful). DOS does not receive 
the simulated interruption until it enables channel interruptions through 
an LPSW. The CSW built during the previously staged SIO simulation is 
now moved into the DOS low storage area. 


Printer overflow is handled by module IIVPOV, which simulates the printer 
Carriage tape operation to DOS. This function provides channel 9 and 12 
indications for DOS in the same manner as the hardware does. (See "Printer 
Overflow Simulation" for more details.) 


Staged I/O uses the following modules (see Figure 9): 
TIVSTG - contains the main logic for staging both input and output. 


ITIVAWV = verifies the validity of the DOS CAW and locates the first 
ccw for the I/O operation. 


ITVCWV - verifies the validity of the CCW being processed and follows 
the channel program logic by replacing the addresses of 
the TIC (transfer in channel) CCWs with the ccW addresses 
to which the TICs point. 


IIVFOV - supports printer overflow. This module may be omitted from 
the Emulator linkage editor at the system programmer's 
discretion by coding PARM.LKED=LET. 


IIVFCB = is the FCB image that resides in SYS1.IMAGELIB. Module 
IIVSTG converts this image to an Emulator format forms- 
control image (FCB2EM01). 


TIVPR1 - contains the command code translate table for 1403 and 1443 
Printers. 
TIVRP1 - contains the command code translate table for a 2540 Card 


Read Punch. 


IIVRD1 - contains valid reader commands in the command code translate 
table for a 1442 Card Read Punch. 


IIVPU1 = contains valid punch commands in the command code translate 
table for a 1442 Card Read Punch. 


TIVRD2 = has the same function as IIVRD1 for a 2520 Card Read Punch. 

LIVPU2 = has the same function as ITVPU1 for a 2520 Card Read Punch. 

IIVRD3 = contains the command code translate table for a 2501 Card 
Reader. 

IIVPU3 - contains a command code translate table for a 3525 punch. 
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3. I/O operations - all other I/O requests. In general, by issuing the EXcP 


macro instruction, the Emulator requests the execution of the channel 

program specified in the IOB. To initiate execution of the channel program, .) 
the Operating System obktains its address from the IOB, places thi ddress 

in the CAW, and issues an SIO instruction. (For further informati vy 4 VA ; 
concerning channel rfrogram execution, see Data Management for System . AD. 


Programmers for OS or OS/VS.) 


The channel program is surplied by DOS and is composed of CCWs on doukleword 
boundaries. Each CCW specifies a command to be executed and, for commands 
that initiate data transfer, the area to or from which the data is to be 
transferred. 


Before issuing the EXCP macro instruction, the Emulator must adjust the 
data addresses in each CCW through the use of adjust CCW string, a DOS 
Compatibility Feature instruction. (See the Appendix for a detailed 
description of this instruction.) When the input/output overation is 
complete, the CCW data addresses are readjusted to their original values. 


The DOS channel program is then executed with the following exceptions: 


e For direct-access devices, the DOS initial CCW sequence of SEEK-TIC 
or SEEK-SET FILE MASK-TIC is bypassed by the Emulator so that the 
OS functicn is not surprressed. 


e For magnetic-tape devices, the DOS initial SET MODE-TIC sequence, 
if present, is bypassed by the Emulator. If the set mode opcode is 
different than that contained in the OS DEB, a stand-alone set mode 
is issued so that the Emulator start I/O appendage can move the new 
set mode opcode to the DEB. The remainder of the DOS user's channel 
program is then executed. 


I/O Appendages 


A start I/0, end-of-extent, channel end, and abnormal end appendage (IGG019SA) 
and an abnormal end/channel end appendage (1IGG019S1), both of which reside 
on SYS1.SVCLIB, are used by the Emulator. 


Start I/O, End-of-Extent, Channel Fnd, and Abnormal End Arprendage 


The Emulator issues an OPEN macro to open the vToc of each dedicated direct- 
access volume to be used in an emulation run. OS OPEN builds a DEB in protected 
storage for each direct-access device, reflecting the upper and lower bounds 

of each VTOC data set. Any subsequent attempt to gain access to data outside 

of these boundaries results in an extent violation and termination of the I/0 
operation. 


Since DOS problem frograms must Le able to refer to any location on a dedicated 
DOS volume, and not just the vTOC, the extent limits in each DEB must be changed 
to specify the extents of the cylinder being accessed each time an extent 
violation occurs. The Emulator's end-of-extent appendage, running with a 
protect key of 0, is able to enter protected storage and make this change 

before an SIO instruction is issued. This appendage is used only for DOS 
private volumes. 


This does not hold true for data sets on shared volumes since the data set 
defined in the DD statement is opened and not the VTOC. 
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Prior to execution of the OS SIO and after the Emulator EXCP is issued, the 
start I/O appendage is entered to modify the DASD volume's file mask in the 
DEB. The file mask is modified in conformance with the DOS SFM command. If 
DOS does not issue an SFM command, the file mask is set to X'00'. The start 
I/O appendage is also entered to modify the tape set mode opcode in the DEB 
to conform to the mode requested by the DOS I/O supervisor. 


Abnormal End/Channel End Appendage 


The Emulator uses the abnormal end appendage to bypass the OS error recovery 
procedures for an end-of-cylinder condition on a direct-access device anda 
rewind-unload condition for tape or channel 9 is encountered for printer 
devices. When one of these conditions is detected, the abnormal end appendage 
resets the IOB exception flag to prevent the OS error recovery procedures from 
being entered. A normal return to the OS I/O supervisor is made and the I/0 
operation is posted complete. 


The channel end appendage is entered for all tape and unit record devices at 
channel end. Upon receiving an incorrect length unit exception indication, 

the appendage turns off the IOB exception flag to prevent the OS I/O supervisor 
from loading error recovery routines. Otherwise, the I/O supervisor performs 
its normal processing. For chaining checks on tape, this appendage turns on 
the data chain bit in IOBFLAG1 to inform the tape error recovery procedures 

not to retry the channel program. 


Asynchronous Interruptions 


The asynchronous interruption address field (bytes 36-39) of the local execution 


list contains the storage address of module IIVRTE. This module gains control 
from OS after the processing of an asynchronous interruption that occurred 
while DOS was in control. 


The main functions of this module are to process DOS-initiated asynchronous 
interruptions and to pass control to DOS by issuing the execute local 
instruction. (See "Passing Control to DOS" for details.) 


Input/Output Interruptions 


The ECBs that are pointed to by entries in the FCB pointer table are tested 
and a post ECB list entry is created for each ECR indicating I/O completion. 
When the system mask portion of the local execution PSW is set so that I/0 
interruptions are enabled and one or more post ECB list entries exist, a 
hardware interruption is simulated to DOS. 


The CSW is moved from the IOB to DOS location 64. The local execution PSw 

is moved to the DOS T/O old PSW and the DOS channel and unit address is placed 
in the interruption code portion of the DOS IYO old PSW. The DOS I/O new PSW 
is then moved to the local execution PSW. If the interruption was initiated 
by a reply of ATTN to the Emulator prompt, the attention bit in the status 
portion of the DOS CSW is set to 1. When the execute local instruction is 
issued, the interruption is simulated. 


Method of Operation 


29 


Interval Timer Interruptions 


The 9S supervisor macro instruction STIMER is issued at 1-second intervals 
when the Emulator parameter DOSTIM=YES has been specified in the PARM field 
of the EXEC statement. This ensures the continuous maintenance of the DOS 
interval timer. Accuracy of the DOS interval timer will depend upon the 
priority of the Emulator job. B 4 


When the ECB associated with the expiratgion of a 1-second interval has been 
posted, DOS location 80 is decreased hy and the STIMER is reissued. When 
the DOS timer value becomes negative and the system mask portion of the local 
execution PSW is set so that external interruptions are enabled, a timer 
(external) interruption is simulated to DOS. 


The local execution PSW is moved to the DOS external old PSW and the bOS 
external new PSW is moved to the local execution PSW. When the execute local 
instruction is issued, the interruption is simulated. 


External Interruption Simulation 


When an operator-initiated external interruption is required by a DOS problem 
program, the operator replies EXT to the Emulator prompt. If the system mask 
portion of the local execution PSW is set so that external interruptions are 
enabled, the local execution PSW is moved to the DOS external old PSW and the 
DOS external new PSW is moved to the local execution PSW. When the execute 
local instruction is issued, the interruption is simulated. 


DIRECT-ACCESS VOLUME SHARING 


With the removal of the Version 1 requirement for private volumes, DOS and 
OS data sets can now reside on the same DASD volume. This is optional for 
one or more volumes in an Emulator job step. DOS indexed sequential files, 
however, carnot be shared and must be accessed from dedicated volumes. 


A data set located on a shared volume is defined through OS [D statements, 
and its allocation and maintenance in the VTOC is done through OS JCL by the 
OS direct-access device space management (DADSM) routines. 


When DOS wants to allocate a file, as specified by DOS DLBL and EXTENT 
statements, the open routines maintain the vVTOC of the DOS file to its 
corresponding volume by using the information in the DTF (type of file, extent 
sequence number) and the DLBL/EXTENT card image (location of the file on the 
volume, total number of extents, type of extents). 


The volume-sharing simulation routines, TIVGR2, IIVDVS, and TIVVIO, update 

the DOS DTF and DLBL/EXTENT image to reflect the status of the file as allocated 
by OS. They also simulate a DOS access to the VTOC, either by issuing an OS 
OBTAIN macro when DOS issues a read to the volume label or an identifier (format 
1) or extension (format 3) DSCB or by bypassing the I/0 operation when DOS 
issues a write to the vTOC. In addition, module IIVDVS changes the flow of 

DOS B-transient phases so that some will be bypassed. 


This section explains in more detail the flow of control between DOS B-transient 
phases and the Emulator, and outlines the relationship between the Emulator 
routines and the Emulator control blocks involved. Figure 10 gives an example 
of open/close processing for a sequential disk output file. 


30 DOS Emulator Logic 


J 


statements 


Label cylinder 
volume 
DOS SYSRES 


Figure 10. 


DOS DLBL/EXTENT 


Creates label cylinder 

entry from DLBL/ 

EXTENT statements 
DOS Problem (4) 


Program 
e Starts processing 
¢ Issues a DOS OPEN 


$$BOPEN 


Initializes Open table 


$$BOSD00 
$$BOSD01 
Reads first 
DLBL/EXTENT 
into sotrage 


iVSVC 
Intercepts SVC 2 
IvGR2 © 


e Locates DOS file ID 
and symbolic unit 
number in DLBL/ 
EXTENT 

e Locates DOS PUB 


entry and points to 
COMTAB entry 

s Searches each CTEXT 
for DSname identi- 
cal to DOS file ID 


IWVDVS 6) OPEN 


e Creates and opens 
DCB 

e Obtains F1 and F3 
from OS; builds VOL. 1 

* Updates DLBL. with 

OS limits from DEB 


¢Creates FID 


*Emulator receives 
control as an OS 
problem program 


DADSM ® 


Allocates space for the 
data set 


@ 


OS DD Statements 


IIVENT/HVINT 


Builds various 
Emulator control 
blocks 


123456 


$$BOSD04 


IIVVIO 
e Gives actual F1 address 


Eee al and builds FO 


e Bypasses write F1 


e Finds FO in VTOC 
and searches for FO 
e Builds F1 label and 


writes F1 
e Posts extent limits 
e Puts F1 address in DTF 


DOS Problem 
Program 


e Continues processing 
e Issues DOS Close 
$$BOSDC1 CLOSE 


e Initializes close 
e Reads VOL 1 


IIvVIO 


¢Gives VOL 1 
as created 
© Gives F1 
« Bypasses write F1 


e Reads F 1 
* Writes F1 
* Updates DT F 


IIVGR2 (1) 
Locates DTF in FID 
ItVDVS 


e Frees FID space 

* Closes OS data set 

»« Frees DCB space 
DOS Problem 
Program 


Continues processing 


— — @ |/O for the Open 
routines 

——t Flow of control for 
the Open/Close 
routines 


Example of Open/Close Processing for a Sequential Disk 


Output File 


Method of Operation 31 


Note!:; In order to understand the following, familiarity with DOS open/close 


SN ET <TR 


details. 


Numbers through apply to OS sequential DASD and direct-access shared 
data sets~and to DOS s@€quential DASD and direct-access shared files. Indexed 
sequential shared data sets are discussed in "OS Indexed Sequential Data Set 
Sharing" later in this section. 


Note2: The through 3) appl correspond to the encircled numbers in the figure. 


(1) The Emulator is called with the following OS control statements: 


//7EMU JOB ACT#,name, MSGLEVEL=1 

// EXEC PGM=ITIVEMU, PARM= (*XXXXxX¥xX') 
//SYSEM191 DD UNIT= 2314, VOL=SER=123456, 

// DSN=DOSFILA, DISP= (NEW, KEEP), 
// SPACE= (CYL, (1) ) 


OS JCL reads the DD statements and builds the corresponding JFCBs. 


The OS initiator uses the JFCBs to perform space management on the requested 
volume as follows: 


(a) Determine whether volume 123456 is mounted and, if not, look for an 
available device and issue a MOUNT message to the operator 


(b) Allocate auxiliary storage space on the volume by searching the vToc 
for an identifier (format 1) DSCB to be created and a free cylinder 
extent to be allocated to file DOSFILA 


The vVroc of 123456 volume will then contain an identifier (format 1) DSCB 
describing DOSFILA file. 


(2) The Emulator initialization routines read the JFCBs and build the Emulator 
control blocks. One COMTAB extension containing SYSEM191 in the CTDDNAME 
field and DOSFILA in the CTDSNAME field is created and chained to the 
COMTAB entry for DOSCUU=191. Refer to Figure 11 for the relationship of 
control blocks affected by IIVDVS. 


(3) The DOS problem program is then called with the following control 
Statements: 


“7/7 JOB DOS,-..-- 


// DLBL DTF1,'DOSFILA' ,99/365 
// EXTENT SYS001,,,10,10 
// ASSGN S¥YS0Q01,X'191° 


// EXEC PROGRAM 
/* 


DOS JcL reads the DLBL and EXTENT statements and creates a DLBL/EXTENT 
record in the label cylinder of the DOS system-residence pack. Logical 
unit SYS001 is then assigned to physical unit 191. 
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Figure 11. Data Areas Affected by Open Processing (IIVDVS) 


(4) The DOS problem program issues an OPEN macro for DTF1. After the DOS B- 
transient phases $$BOPEN and $$BOSD00 have been executed, phase $$BOSD01 
locates, in the label cylinder, the DLBL/EXTENT record associated with 
DTF1, and builds the DLBL/EXTENT image in the open table, which is located 
in the DOS B-transient area. $$BOSDO1 releases control by issuing an SVC 
2 instruction to load $$BOSDO1. 


The Emulator supervisor call routine (IIVSVC) traps this SVC 2 and passes 
control to module IIVGR2 to monitor the call. 


(5) IIVGR2 then locates the DOS file ID and logical unit number (here DOSFILA 
and SYS001) in the DLBL/EXTENT image, locates the DOS PUB entry associated 
with the logical unit (here 191), locates the corresponding COMTAB entry, 
and searches each associated COMTAB extension for a DSname identical to 
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the DOS file ID. When a match indicating a volume-shared file is found, 
module IIVGR2 sets the COMTAB extension address, open code, DTF address, 
and DOS LTK in the PARMLST field in EMUCONS. Then control is passed to 
module IIVDVS to perform OS open processing for the file described in the 
COMTAB extension entry. 


Module IIVDVS creates a FID containing a pointer to the COMTAB extension 
entry in the FIDCTXTN field. The name of the DTF is placed in the FIDTFNME 
field of the FID. IIVDVS then attaches this FID to the FID chain pointed 
to by DSFIDBLK in EMUCONS. The use count located in the COMTAB extension 
is increased by 1. 


If the value of the use count equals 1, a DCB is created and opened, and 
its address is moved into the COMTAB extension. At this point, module 
IIVDVS issues an OS OBTAIN macro to get the identifier (format 1) DSCB 
address and contents from the VTOC and builds a volume 1 image, format 

1 image, and format 3 image (if a format 3 DSCB was created) in the obtain 
work area pointed to by EMUCONS. The actual identifier (format 1) DSCB 
address is moved into the open table (see Section V for the format of the 
open table). Other indicators (‘format 4 indicator’ and ‘return message 
indicator') are set in the open table to reflect the fact that DOS phases 
SS$BOSD01, SSBOSDO2, $S$BOSDO3, and $#BOSDO8 have been bypassed. 


IIVDVS last updates the DLBL/EXTENT image in the B-transient area to reflect 
the type of extents and location of the extents as given by the OS DER. 
IIVDVS returns control to IIVGR2 after setting $$BOSDO4 in NXTBTR in 
EMUCONS. TIIVGR2 then updates the B-transient phase name with $S$$BOSDOU 

and control iS given to DOS B-transient phase $$BOSDO4. 


Note that DOS open phases $$BOSD01, $$BOSDO02, S$SBOSDO03, and fSBOSD08, which 
deal with space allocation in the VTOC, are not executed. 


$$BOSD04 searches the VTOC to find a free DSCB by issuing the following 
channel program: 


e "Seek, search on ID equal, TIC to locate the beginning of the VTOC 
(address found in the open table) 


e "Read count, search on key equal to 0, TIC' to find the first free 
vVToC record (format 0) DSCB 


Module IIVPCE intercepts the SIO and determines that the seek address is 
not contained in any of the DEBs attached to the COMTAB extension entries 
for this DOS cuu. IIVPCE then passes control to IIVVIO, which identifies 
the DOS channel program as a search DSCB, format 0 type, and simulates 

it by passing to DOS the count field of the actual identifier (format 1) 
DSCB as found in the obtain work area. 


The same processing is done for the write identifier (format 1) DSCB channel 
program issued by $$BOSD04, which is recognized and bypassed by module 
TIVVIO. 


SSBOSDO4 then updates the DTF (with extent limits) or initializes it (with 
record number and identifier (format 1) DSCB address). 


Note that the extent limits are obtained from the DLBL/EXTENT image in 
the DOS B-transient area. They are, therefore, the actual limits as 
determined by the OS space allocation routine because they were moved to 
the DLBL/EXTENT image by IIVDVS (see step ) . Open processing is now 
complete. The DOS problem program will evefitually issue a CLOSE macro 
for DTF1 and control will then be given to DOS B-transient phase $$BOSDC1. 


$$BOSDC1 updates the format 1 DSCB to indicate the file has been 
successfully created. The three channel programs issued (read volume 1, 
read format 1 DSCB, rewrite format 1 DSCB are intercepted_by IIVPCE, and 
recognized and simulated by IIVVIO as explained in step j 
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$$BOSDC1 releases control by issuing an SVC 11 instruction, which is trapped 
by IIVSvc and recognized by IIVGR2 as the end of a DOS close operation. 


® Module IIVGR2 identifies the file as a volume-shared file by searching 
the FID chain addressed by DSFIDBLK for a matching DTF name and LTK. A 
match indicates a volume-shared file, and control is passed to module 
IIVDVS to close the OS file. 


42) Module IIVDVS deletes the FID associated with the file from the FID chain. 
The use count in the corresponding COMTAB extension entry is decreased 
by 1. If the new use count is greater than 0, more than one DTF is 
accesSing the same file and at least one DTF is still open. 


A use count of 0 indicates that no more DTFs for the file remain open. 
An OS CLOSE macro is then issued, and the storage space occupied by the 
DCB is released. 


Control is eventually returned to modules IIVGR2 and IIVSVC, and the latter 
issues an SVC 11 instruction. 


End-of-Extent Processing 


Upon reaching the end of an extent for an output file, the DOS problem program 
calls $$BOPEN to open the next extent. 


The processing is like open processing except for two steps: 


1. In updating the DLBL/EXTENT image (step Q@)), module IIVDVS obtains the 
current extent sequence number from the DTF and searches the associated 
DEB for this extent. If this extent is not found, an OS EOV Svc is issued 
to obtain secondary allocation, if any is specified in the DD statement. 
Module IIVDVS then moves the limits of the current extent from the DEB 
to the DLBL/EXTENT image in the DOS B-transient area. If at the time the 
data set was created no secondary allocation was specified in the DD 
statement or if more than 16 extents have already been allocated, a message 
is issued and the DOS step is canceled. 


2. In the next DOS phase to be executed (step (8)) , LIVDVS sets $S$f#BOSDOS in 
the NXTBTR field of EMUCONS. This phase, when executed, issues a channel 
program to read the identifier (format 1) DSCB from the VTOC, and then 
tries to rewrite the DSCB with an additional extent. Both channel programs 
are intercepted by module IIVVIO and simulated. 


Input Processing 


Steps CG) through (6) are identical. IIVGR2 takes control when $$BOSDI1 is 
called, and IIVDVS moves $$BOSDI2 into the NXTBTR field in EMUCONS. $$BOSDI2 
then attempts to read the identifier (format 1) DSCB. This attempt is 
intercepted by module IIVVIO, which gives back the actual OS identifier (format 
1) DSCB. 


workfile Processin 


The first call for $$BOSDW1 is similar to the open for an output file. The 
Emulator, in step , moves to the DLBL/EXTENT image the actual limits of 
the first extent as found in the DEB, replaces #$SBOSDW1 and f£SBOSDW2 in the 
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NXTBTR field of EMUCONS, and sets the indicators "extent open" and "SYSxxx 
in DTF" in the DTF. 


A test is made to determine whether this extent is the last one allocated, 
and the bit indicating "last extent" is set on in the DLBL. 


$SBOSDW2 updates the DTF to reflect the limits of the first‘extent (as set 
in the DLBL/EXTENT image) and calls $$BOSDW1 again. This second call for 
$$BOSDW1 is then trapped by module IIVGR2 and control is passed to module 
IIVDVS. If the "last extent" bit is on, control is returned to DOS, which 
terminates the open processing. 


If the "last extent" bit is off, module IIVDVS moves the limits of the next 
extent from the DEB to the DLBL/EXTENT image. Note that for workfiles, module 
IIVDVS never issues an OS EOV SVC. Specification of the secondary space 
parameter in the DD statement will, therefore, not be useful. 


End-of-extent processing for a workfile is similar to open processingg for 
an input file, because all the extents have been allocated when the file was 
opened and have already been created in the DSCB. 


Module IIVVIO intercepts the "read format 1 DSCB" or “read format 3 DSCB" 
channel program issued by $$BOSDW3 and simulates it by returning the actual 
format 1 DSCB or format 3 DSCB as set in the obtain work area. 


Direct-Access File Processing 


Direct-access file processing is very similar to the open of a sequential disk 
input file or sequential disk output file. The main difference is that the 
DLBL/EXTENT image for a direct-access file contains all the extents for the 
output file. 


For an output file, module IIVDVS (step @)) Obtains all the extents from the 
DEB and moves their limits to the DLBL/EXTENT image. Note that module IIVDVS 
never issues an OS EOV SVC for a direct-access file. 


DOS Release 27 Processing 


When emulating a DOS release 27 system, module IIVGR2 traps the Svc 2 for 
S$$BOPEND and moves S$BOPEN in place of $SBOPEND in NXTBTR. Phase S$BOPEND, 
which initializes the system recorder file records by reading the VOL1 record 
for all assigned LUBs to disks, will then be bypassed. 


DOS Release 27 Output Processing 


Since $$BOSDO4 has been divided into two different open phases (SfBOSDO4 and 
$$BOSDO9) in DOS release 27, IIVDVS will bypass $$BOSDO4. IIVDVS moves $$BOSDO9 
in place of NXTBTR and simulates S$$BOSDO4 by setting DOS register 0 with the 
appropriate device type control factor and updating the volume sequence number 
in the DTF. 
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OS Indexed Sequential Data Set Sharing 


Unmodified DOS programs running under the Emulator can gain access to and 
create OS-format data sets. However, the DOS user must comply with OS 
restrictions and requirements. 


A volume-shared OS indexed sequential data set is defined through OS DD cards, 
and its allocation and maintenance in the vToc of the corresponding volume 
is made at OS JCL time via OS DASD space management routines. 


When DOS wants to access an OS indexed sequential data set, as defined by DOS 
DLBL/EXTENT statements, the Emulator gets the user to the proper data set by 
matching the DLBL file ID to the data set name in the DD statement. 


The OS indexed sequential data set sharing simulation routine, TIIVIS, updates 
the DOS DTF that reflects the status of the data set as allocated by OS. The 
open routine in IIVIS replaces the DOS ISFMS open B-transient phases. 


The following section explains in more detail the flow of control between the 
Emulator and DOS, and outlines the relationship between the Emulator routines 
and the data areas affected by open processing (see Figure 12). Figure 13 

is an example of processing OPEN and I/O macros for an OS indexed sequential 
data set. 


Example of Processing 


See numbers @) through (5) in Figure 10 and steps G) through (5) in the text 
under the heading "Direct-access Volume Sharing." These steps are identical 
to those taken when processing a shared OS indexed sequential data set, except 


e SSBOPEN and S$BOPEN2 do the processing for indexed sequential data sets 
in the box showing *SBOSD00 and $SBOSD01 as processing phases, 


e a match (COMTAB extension flag byte = 0) must indicate a shared OS indexed 
sequential data set, and 


® control must be passed to module IIVIS to perform an OS open. 


Method of Operation 


37 


DOS Register 15+ 
1192 offset 


COMTAB 


Ean 


DOS Logical Transient Area 


//| SYSEM191 DD DSN = | DOSFILA 


Byte 0 = X’80’ for 
COMTAB indexed sequential 
a extension data set 


i“ 
ISBLK 
( LUB i epee SYSEM 191 DOSFILA 
N 
sees 


—a stemee, 


™ 
ISBLK ~ 


( puB \ 
Used to search Register Save Area 
191 COMTAB for \ 
device addresses \ 
DOS COMREG PQ BEK | 


DOS Register 
2+ adjustment 
factor 


\ 
PARMLST So DECB \ 
bo 
| 
i 068 immo 2 | 
Le ( 
ey / 
ae 
DTFIS / JFCB / 
(Load only) 
/ 
/ 
/ 


— — —pm !nformation passed during 
Open processing by IIVIS 

> Information passed before 
Open processing 


Figure 12- Data Areas Affected by Open Processing (IIVIS) 


38 DOS Emulator Logic 


DOS DLBL/EXTENT 
statements 


zi 
| 
| 
| 

1 Creates label cylinder 


entry from DLBL/ 
EXTENT statements 


Label cylinder 


alinne DOS Problem @) 
P 
DOS SYSRES ae 
* Starts processing 
» Issues a DOS OPEN 
$$BOPEN 


Initializes open table 


$$BOPEN2 
Reads first 
DLBL/EXTENT 


Subtask into storage 


Traps SVC 2 and 4 
from DOS 
© 


eLocates DOS file ID 
and symbolic unit 
number in 
DLBL/EXTENT 

*Locates DOS PUB 
entry and points to 
COMTAB entry 

¢ Searches each 

CTEXT for DSname 

identical to DOS 

file 1D 


IIVISO1 


¢ Initializes registers 
« Enters wait state 


¢ Regains control 

e Loads DTFIS address 

e Determines function 
(GET, PUT, etc.) 

e Executes mapping 
routine 

e Loads address of 
COMTAB entry from 
ISBLK 

* Creates CSW in 


COMTAB IOB ° Identifies data set 

¢ Posts COMTAB as Indexed Sequential 
entry's ECB 

¢ Branches to wait IVIS (6) OPEN 


state 

«Determines function 
from code in EMUCONS 

¢ Obtains pointers to 
DTFIS and to CTEXT 
from PARMLST in 
EMUCONS 

«Creates ISBLK, chains 
it to ISFIDBLK 

*Opens data set 

* Moves data from DCB 
to DTFIS 

*Resets ISMOD painter 
in DTFIS 

e Attaches subtask 

eReturns to DOS 
problem program 


Figure 13. 


*Emulator receives 
el rn 
problem program 
DADSM 1) 
Allocates space for the 
data set 


IVENT/IUVINT 


Builds various 
Emulator control 
blocks 


OS DD statements 


Volume 


Emulator Task 123456 


1/O Macro 
Processing 


DOS Problem 
Program 


* Issues DOS ISAM 
1/O macro to OS 
Indexed Sequential 


data set 
¢ Gets forced program DOS Problem 
check Program 


IIVPCE (9) 


e Stores ISBLK address 


Enters wait state 
and I/O macro code in 


CCW DOS Supervisor 
¢ Resets local execution 
PSW to DOS wait 
* Translates PC toSVC O 
¢ Switches PSWs 


DOS Supervisor 


Queues I/O request 
for processing 


DOS Problem 
Program ®) 


Enters wait state 


DOS Supervisor @2) 


IWWPCE @3) 


» Determines if request 
is for an OS Indexed 
Sequential data set 

¢ Sets DTFIS and 
COMTAB entry 
addresses and I/O code 
into ISBLK 

* Posts subtask 

e Posts ECB in ISBLK 

e Activates subtask 

DOS 
Supervisor 


Gives control to other 
DOS tasks if any are 
ready to run; if not, 
DOS enters enabled wait 


IIVRTE 


Checks for I/O 
complete; if none, 
Emulator task enters 
wait state until |/O 
completion 


IIVCHK 


Simulates |/O 
interruption to DOS 


DOS Supervisor 


e Posts traffic bit for 
DOS program 

* Sets indicatiors to 
dispatch task when 

it has highest priority 


Gives control back 
to interrupted task ——-& |/O for the Open 
@) Routines 


— pe Flow of control for 
Open and ISAM 


e& processing of an Indexed 
Sequential data set 


Example of Processing OPEN and I/0 Macros for an Os 


Indexed Sequential Data Set 


Method of Operation 39 


i 


The following text is keyed to the encircled numbers in Figure 13. 
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IIVIS determines the function (OPEN here, but it could also be CLOSE or 
SETL) to be performed by examining the code in EMUCONS. It also obtains 
the pointers to the DTFIS and to the COMTAB extension from EMUCONS. IIVIS 
creates a work area called the ISBLK, adds it to the ISFIDBLK chain, and 
opens the data set. 


IIVIS then moves data from the DCB to the DTFIS and resets the ISMOD address 
pointer in DTFIS to trap I/O macro requests. It then attaches a subtask 
to perform I/O macro mapping and returns to the calling routine (IIVGR2). 


The subtask, at entry point IIVISO1, initializes registers and G4 goes 
into a wait state until the SIO subroutine (module IIVPCE) posts the ECB 
in the ISBLK. 


The DOS problem program gets a forced program check when it issues an I/0 
macro for the OS indexed sequential data set. 


IIVPCE, recognizing the program check as a special type, puts the address 
of the ISBLK associated with the DTFIS and the code of the I/O macro to 

be performed into a NOP CCW. It sets the local execution PSW address to 

a DOS WAIT macro contained in the DTFIS. IIVPCE then translates the forced 
program check to an Svc 0 interrupt, switches PSWs, and returns to the 

DOS supervisor. 


The DOS supervisor queues the I/O request for processing. 
The DOS problem program then executes the DOS WAIT macro. 
The DOS supervisor isseus a start I/O. 


The SIO subroutine (module IIVPCE) determines that the request is for an 
OS indexed sequential data set, loads the ISBLK address from the CCW, and 
moves the code from the CCW to the ISBLK control information field. It 
also moves the addresses of the DTFIS and the COMTAB entry associated with 
the I/O request into the ISBLK control information field. 


The SIO subroutine then posts the ISBLK ECB to activate the subtask, 
increments the I/O count, and returns to the DOS supervisor at the 
instruction following the SIO. 


The activated subtask interprets the I/O macro code byte in the ISBLK 
control information field and goes to the related mapping routine. After 
executing the OS macro and moving the logical record to or from DOS storage, 
it maps pertinent information from the DCB to the DTFIS, indicates 
successful completion in the COMTAB IOB, posts the ECB in the COMTAB entry 
associated with the I/O device, and reenters the wait state. 


The Emulator task determines that input/output operations are completed 


on the device associated with the COMTAS entry and simulates an I/0 
interruption to the DOS supervisor. 
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Close Processing 


é After executing steps @) +hrough (5) indicated above, IIVIS determines that 
the close function is the one to be performed. It detaches the subtask, resets 
the DTFIS to its former state, closes the OS indexed sequential data set, 
removes ISBLK from the ISFIDBIK chain, frees the space, and returns to the 
DOS problem program. 


SETL Processing 


After executing steps (4) through (S) indicated above, TIVIS determines that 
the SETL function is the one to be performed, maps the DOS SETL to an OS SETL, 
and returns to the DOS problem program. 


Shared DOS Svstem Residence File 


The DOS sVstem residence file must reside on a standard DOS system residence 
volume. 


The option is selected by coding the DOS system residence file ID as the DSN 
parameter in the SYSEMcuu DD statement that defines the volume for the DOS 

cuu specified in the DOSRES=cuu varameter of the EXEC statement. If DISP=OLD 
is coded, the DOS system residence file will not be shared although the Dos 
system residence volume will be treated as a device shared volume (may contain 
OS data sets). DISP=SHR must be coded on the DD statement in order to share 
the DOS system residence file. 


“When the DOS system residence file is being shared by two or more Fmulator 
ww partitions, a sevarate cylinder on the DOS system residence volume must be 
provided for each Emulator partition to use for the DOS label cylinder. 


A DD statement with the special ddname SYSEMLBL is required to define a single 
cylinder OS data set to be used for the DOS label cylinder. If this DD 
statement is missing, the standard DOS label cylinder contained within the 

DOS System residence file will be used. The DSN parameter may specify anv 
valid data set name. Space allocation must be for one cylinder when the data 
set is created (DISP=NEW specified on the DD statement) and initialization 

of the data set must be performed with the DOS STDLABEL and PARSTD procedures. 


DOS DLBL and EXTENT statements are not required in the DOS job stream for the 
DOS system residence file and DOS label cylinder data sets. 
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ABNORMAL END CONDITIONS 


Serious user or program errors can cause the termination of either a DOS job ) 
or the Emulator itself. 
the cancellation of a DOS job requesting the specific I/O or DTF processing: 


Invalid cCcw 


Each of the following error conditions will cause 


Emulator CCW chain table (BEBLK) overflow 


No seek or bin number 


for a 2321 data cell drive 


Invalid DOS logical unit 

DOS logical unit unassigned or assigned IGN for a shared device 
DTF points to a null DOS PUB table entry 

Cannot match file ID with dsname 

Incompatible file organization 

DCB and DTF device typnes incompatible 

DOS POINT MACRO not within extents of a given file 

Invalid DOS seek address 

Insufficient extent space in DOS DLBL/EXTENT image for DTF 


Wser labels specified 


in DTF but not in CDSCB 


Cannot get more extents for file 
Cannot obtain F1 for file 


Emulator termination will be caused by any of the following conditions: 


An attempt by DOS to load a hard wait PSW 

An invalid or undefined DOS IPL or DOSLOG device 
Insufficient storage for emulation 

Open for DOSRES was unsuccessful 

Could not find PUB entry in the DOS PUB table during DCS IPL 


(When DOSIPL # AUTO) 


A DOS PUB entry did not exist for the DOSIPL device 
Device not supported by the Emulator 


DOS device address in 
device type 


DD statement not compatible with oS ) 


Invalid DOS device address specified in DD statement (when DOSTIPL 


# AUTO) 


Syntax errors in DEBUG statement when using card input 
Duplicate DOS device addresses 


Could not IPL DOS for 


DOS emulation 


Permanent I/O error while loading IPL routines 


Invalid automatic ADD 
mrror while canceling 


A dump of the contents of 
if a SYSSNAP DD statement 


16, 
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20 or 24. (Control is 


DOS Emulator Logic 


request 
the Emulator 


the DOS storage area and registers is taken only 
is present and the error return code is other than 
then returned to OS. 


DETAILED ROUTINE DESCRIPTIONS 


Each Emulator routine description consists of the following parts: 
e A statement of the general function (s) 
e A narrative description of the function(s) 


e Operational diagrams when necessary 


DOS Emulator Entry Routine (IIVENT) -- Flowchart 1A 


ITVENT, the controlling routine during Emulator initialization, passes control 
to IIVINT and ITVIN2 so that these modules can perform initialization functions 
for the Emlator. 


IIVENT saves the contents of the general purpose registers and the pointer 
to the user parameter area. The CSECT, TIIVCON, which is used for communication 
between the modules of the Emulator, is defined in this module. 


Initialization First-Load Routine (IIVINT) -- Flowcharts 2A-2M 


IIVINT performs four functions in initializing the Emulator: 


Verifies parameters 

Establishes DOS storage 
Builds COMTAB 
Builds COMTAB extension 


On entry to this module, the local execution list and adjust CCW data address 
list are aligned to 64-byte boundaries within the CSECT containing the Emulator 
constants. The Emulator kase registers are initialized as follows: 


e Register 9 contains the address of the local execution list. 
e Register 10 contains the address of DCS storage. 
° Register 11 contains the address of the Emulator constants area. 


Verifies Parameters 


The address of the user parameter area is obtained from IIVENT. The varameter 
area is scanned for the DOS channel and unit number of the DOS resident file 
(DOSRES=), the DOS IPL unit (DOSTPL=), the DOS console (DOSLOG=), and the DOS 
system size (DOSSYS=). These parameters are validated and checked to ensure 


that required parameters have been specified correctly. If a required parameter 


was not provided on the EXEC statement, a message is issued to the operator 
requesting the information. 
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ITVINT also looks for three other parameters: 


{ ,AUTOEOJ= {YES} ] specifies whether automatic ending of emulation is ) 
[ {NO} ] desired 

[ , DOSTIM= {YES} ] specifies whether timer survort is desired 

r {NO} ] 


f ,APROMPT= {YES} ] requests an abbreviated initial crompt 
[ {NO} ] 


AUTOEOJ defaults to NO, DOSTIM defaults to YES, and APROMPT defaults to NO. 


Establishes DOS Storage 


DOS operates in the first block of storage obtained by the Emulator (Figure 
14). The DOS storage size parameter is used to determine the amount of storage 
needed. The value specified in the DOSSYS parameter is increased by 4K bvtes 
and the Emulator GETMAIN routine (TIVGET) is called. The extra 4K bytes are 
used to adjust DOS storage to a 4K boundary. After DOS storage is adjusted, 
the beginning address is saved and the remaining storage at each end of the 

DOS area is freed. All of DOS storage is initialized to zeros. 


Builds COMTAB 


calculate the number of devices allocated to DOS. The count is used to compute 
the size of COMTAB and is placed in the Emulator constants area (TIVCON) for 
future use in computing the size of other tables. The size of COMTAB is the 
DD entry count plus 1 for SYSLOG times the size of one COMTAB entry. Storage 
area is obtained for COMTAB by the Emulator GETMAIN routine (IIVGET). 


The ddnames in the TIOT that begin with the characters SYSE are counted to ) 


Fach COMTAB entry is initialized to 0 and the following data is entered: 
e The DOS channel and unit address is entered from the TIOT ddname. 


e The OS channel and unit address is entered from the UCB channel and unit 
address field. 


e The OS device type is entered from the UCB. 


e The CTFLAG fields are used to flag the entry for DOSLOG. They are also 
used to flag staged and shared devices. The JFCB is checked to determine 
whether a device is staged (JFCBTSDM set to X*20') or shared. 


@ If the JFCB indicated a staged device, CTFLAG2 is set to indicate whether 
the staging is for an input or output device (determined from byte 18 of 
the data set name). 


e If the JFCB indicates a shared device, a COMTAB extension entrv is 
temporarily built in the CCMTAB entry. This temporary COMTAB extension 
consists of the ddname and dsname. The shared device flag in COMTAB is 
set to indicate the presence of a temporary COMTAB extension. 


e The DOS SYSRES flag is set in the COMTAB entry associated with the DOS 
system residence volume. 
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Leftover Storage 


Aligned DOS Aligned DOS 
DOS Storage + 4K Storage Storage 


4K ——> 4K 


Boundary Boundary 
Leftover Storage 


Storage is obtained for DOS storage is aligned to Leftover storage is freed. 
DOS + 4K bytes. 4K boundary 


[| Dynamic storage owned by the Emulator 
SL LLL) Free dynamic storage 


Figure 14. DOS Storage in Emulator Region 


Builds COMTAB Extension 


The number of ddnames in the TIOT that begin with three characters other than 
'SsYyS', plus the DD statement labeled 'SYSEMLBL' if present, are counted to 
find out the number of data sets that reside on shared direct-access devices. 
The count is used to compute the storage needed for the COMTAB extension. 
This storage is obtained by means of module IIVGET. 

An appropriate error message is issued followed by Emulator termination if: 


e The OS cuu associated with the SYSEMLBL DD statement does not match the 
OS cuu for the DOS system residence volume. 


e DISP=SHR was specified in the SYSEMLBL DD statement. 
Each COMTAB extension is formatted with: 


° The UCB channel and unit address (used during Emulator initialization only 
and not present in the COMTAB extension after initialization) 


e The data set name from the JFCB 
° The ddname from the TIOT entry 
e A flag is set in the flag byte if the ddname is SYSEMLBL 


TIVINT then returns to IILVENT. 
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Initialization Subroutines 


The following Emulator subroutines are used by IIVINT: 


SCAN Subroutine (Flowchart 2K). This subroutine is used by IIVINT to scan 
the user parameter area for a blank or comma. When entered, this subroutine 
computes the address and length of the next user parameter. 


This subroutine has two returns to the user. One return indicates that the 
end of the area being scanned has been reached (scan completed). The other 
return gives the beginning address of a field in register 3 and the length 
of the user parameter in register 4. 


YESORNO Subroutine (Flowchart 2K). This subroutine is used to check the 


validity of parameters that require YES or NO responses, Its return is into 
a branch table: 


° Return address + 0 - parameter missing 
e Return address + 4 - parameter = YES 

e Return address + 8 ~- parameter = NO 

e Return address + 12 - parameter invalid 


CHKCUU_ Subroutine (Flowchart 2L). CHKCUU checks the parameter value given 
on the Emulator EXEC statement. It verifies the validity of a channel and 


unit address. This routine has two returns. It returns to the address in 
register 14 plus 4 if the cuu checked was missing, had an invalid length, or 
had an invalid range. If the cuu checked was valid, it returns to the address 


in register 14. 
3066? 


ASKOPR Subroutine (Flowchart 2L). Nthis common subroutine is used by IIVINT 
to request required parameters from\the operator from the operation that were 
omitted or correcti if invali arameters from the operator. It issues a 
WTOR to the console and waits on the reply. The reply is checked, 

If it was CANCEL, ASKOPR kEranches to the common emulation termination routine; 
otherwise, it returns to the calling routine. 


IDSCAN Subroutine (Flowchart 2M). This subroutine scans the PDnames in the 
TIOT for entries with DDnames beginning with SYSE. If register 2 contains 
zeros, this subroutine gets the address of the TIOT from the Emulator constants 
area (ITVCON) and starts scanning the TIOT for an SYSE entry. If register 

2 does not contain zeros, the address it contains is assumed to be the starting 
address within the TIOT for the scan. 


There are three exits from this initialization subroutine. A return to the 
address in register 14 denotes that all TIOT entries have been examined. If 
this subroutine returns to the address in register 14 plus 4, the address of 

an SYSE entry is in register 2. When it returns to the address in register 

14 plus 8, register 2 contains the address of a TIOT DDname that does not begin 
with SYS. 
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Initialization Second-Load Routine (TIVIN2) -- Flowcharts 3A-3F 


The second-load initialization routine performs the following initialization: 
e Moves temporary TCOMTAB extenSions from COMTAB to available COMTAB extension 


e Chains COMTAB entries to COMTAB extensions and chains together COMTAB 
extension entries 


e Sorts COMTAB entries 


e Builds and initializes other Emulator tables, such as the IS/SSK table, 
the ECB pointer table, and the post ECB list 


° Performs IPL from DOS resident volume 


Moves Temporary COMTAB Extension 


The COMTAB table is searched for temporary COMTAB extension entries. All 
temporary COMTAB extensions are moved to available COMTAB extension entries. 


Chains COMTAB Entries and COMTAB Extensions 


One COMTAB entry exists for every DOS PUB table entry being used. If a COMTAB 
entry is marked for direct-access device sharing, then there exists at least 
one COMTAB extension that is related to the COMTAB entry. A COMTAB extension 
entry describes a data set residing on a DASD shared volume. Chaining is 
required since there may be a group of related COMTAB extensions associated 
with one or more CCMTAB entries. 


Each COMTAB entry is chained to the first related COMTAB extension entry and 
all associated COMTAB extension entries are forward chained together (Figure 
15). 


Sorts COMTAB Entries 


The COMTAB entries are sorted by the DOS channel and unit address and placed 
in ascending order. 


This section of initialization is enqueued by means of a master ENQ to ensure 
that only one DOS Emulator will be building a COMTAB at any given time. To 
prevent more than one DOS Emulator from using the same OS direct-access device, 
the OS channel and unit address is also enqueued by means of a device ENQ. 

At the end of the device enqueueing routine, a master DEQ is performed. Other 
DOS Emulators may not use direct=access devices reserved by the device ENQ 

for this Emulator unless both Emulators specify DISP=SHR in their DD statements. 
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COMTAB Extension 


Communications Table 


COMTAB 
Extension 
COMTAB Entry Entry 
\ 
\ 
\ 
\ 
| 
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One entry for every data set residing 
on a shared direct-access device 


One entry for every DOS PUB table entry used 


——— COMTAB pointers to 
COMTAB extension entries 


—-——-—--— B Pointers from one COMTAB 
extension entry (CTEXT) to 
related CTEXT (in the case of 
2 data sets on the same volume) 


Figure 15. Relationship of COMTAB to COMTAB Extension 
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Builds and Initializes Other Emulator Tables 


This section of initialization code obtains storage area and initializes the 
ISK/SSK table, the ECB pointer table, and the post ECB list. 


One byte for every 2K bytes of DOS storage is obtained for the ISK/SSK 
table. This table is initialized to zeros. 


e The size of the ECB pointer table is the number of entries in COMTAR plus 
3, times the length of one entry. Each entry consists of a 4-byte address. 
Storage is obtained for this table; the first entry is initialized with 
the address of the prompt ECB, the second with the address of the WTOR 
ECB, and the third with the address of the timer ECB. The rest of the 
entries are initialized sequentially with the addresses of the ECBs entered 
in COMTAB. 


e Storage is obtained for the post ECR list so that the list contains a list 
of 2-bvte entries, each representing a COMTAB entry. The table is 
initialized to zeros. 


Performs IPL from DOS Resident Volume 


The initialization second-load routine builds and opens a DCB for the DOS 
system residence volume or the DOS system residence file if the shared DOS 
system residence option has been selected. The COMTAB entry for the DOS 
resident volume is modified to reflect that the volume is open and to contain 
the address of the DCB. The data set specified in the SYSEMLBL PD statement 
is opened if present. 


DOS IPL is a two-phase program consisting of two DOS programs: 
e $$ASIPL1, 64-byte bootstrap records, and 
e €$ASTPL2, the first load of a DOS IPL phase of fewer than 4096 bytes. 


The DOS $SA$IPL1 bootstrap records are located on DOS SYSRES at 00 00 1 (cc 

HH R) and 00 00 2 (CC FH R). The Emulator builds the necessary channel programs 
to read the bootstrap records into DOS storage at DOS location 0. The bootstrap 
records consists of a PSW at DOS location 0, followed by seven CCWs. The 
Fmulator adjusts the data addresses in the last three ccWs. When these three 
CcCWs are executed, the DOS IPL phase (S$AIPL2) is loaded at location 12K in 

DOS storage. 


At this point, $$ASIPL2 in the DOS storage area is ready for executing its 
own IPL. JIIVIN2 scans the $SA$IPL2 phase for the first DOS instruction in 
the loop that zeros the DOS storage area in search of the DOS system size. 
When the initialization second-load routine finds that instruction fan MVC) 
in $$AS$IPL2, it replaces the operation code with zeros. 


Later, when DOS executes this instruction, it gets a program check. Control 

is given to the Emulator program check executive routine (IIVPCE). The Fmulator 
Simulates a program interruption for addressing, places the DOS storage area 
ending address in register 11, and reenters local execution mode at the location 
pointed to by the DOS program new PSW. 


If staged I/O support has been requested, module IIVIN2 loads IIVSTG and IIVSDT. 
If a //SYSDEBUG DD statement was present, module IIVIN2 calls IIVRAS to read 
debuaging parameters. The initialization second-load routine gives control 

to module IIVRTE or, if error conditions were detected, module IIVENT. Figure 
16 is a map of the Emulator region at this time. 
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High 
Storage 


S$SASIPL2 
(loaded at 
location 12K 
in DOS 
storage) 


DOS Storage 


DOS Emulator 


Bootstrap 
CCW String to Read $$A$IPL2 records 
S$$SASIPL1 


DOS Emulator Modules and Tables J 


Low 
Storage 


1 The Emulator zeroes out the op code of the first DOS instruction in the DOS clear storage routine. 


Figure 16. OS Region at Beginning of DOS IPL 
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TPL Add Routine (ITIVADD) -- Flowcharts 4A-4D 


Module IIVADD is entered only when the DOSIPL parameter is coded with the AUTO 
option. When TIvsvec calls this routine, it provides a pointer to a DOS channel 
program that reads in the IPL control statements. When entered for the first 
time, it finds the DOS temporary PUB table and fetches the beginning address 

of COMTAB. Thereafter, orocessing begins with the next COMTAB entrv in the 
table. 


This routine checks the cuu entrv in the DOS PUB table against the cuu entry 
in COMTAB and if a corresvonding entry does not exist in COMTAB, the DOS PU3 
table entry is deleted. The routine also provides an automatic set date and 
time function during TPL. 


The COMTAB is checked for DOS cuutfs that are not in the DOS PIB table. If 

any are missing, this routine adds them to the table. To add a device to the 
DOS PUB table, this routine builds a DOS ADD control statement image and places 
it in the DOS invut area. Upon return to DOS, the IPL control statement image 
provided by this routine will be processed. 


When it is determined that all COMTAB entries have corresponding DOS PUB table 


entries, a set date and time IPL control statement is built and passed to DOS. 
The OS date and time are used. 


Open Routine (IIVOPN) -- Flowcharts 5A-5D 


This routine is called to open Emulator-allocated devices dynamically. The 
caller supplies a pointer to the COMTAB entry requiring the open. The open 


routine gets dynamic storage for the DCB, initializes it, and places its address 


in the COMTAB entry. The device is then opened to permit accessing. 
Five major types of devices are opened by this routine (Figure 17): 
° New volume mount 

Direct-access device 

e Sequential device 

e Staged device 


e Teleprocessing device 


Initialization 


The calling routine places the address of the Emulator COMTAB entry for the 
device to be opened in register 0. Register 15 is initialized with the entry 
point to the open routine. The CTFLAG fields in the COMTAB entry indicate 
whether the open request is for a new volume mount or for a DASD, a sequential 
device, a teleprocessing device, or a staged device. 
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IIVOPN 


) 


Initialization 


Teleprocessing 
Device 


New Volume Direct-Access 
Mount Device (DASD) 


Sequential Device Staged Device 


Common Open 


Figure 17. Open Subroutine Gross Flow 2 


New Volume Mount 


To perform an open operation for the purpose of mounting a new volume, this 
subroutine gets the address of the existing DCB from the COMTAB entry. It 
reads the JFCB into storage and changes the volume serial number. The new 
volume serial number is retrieved from the Emulator CSECT IIVCON, where it 
was placed by the prompt reply processor routine (IIVPRP). 


Direct-Access Device 


Storage is obtained for the DCB, which is formatted to describe a direct-access 
data set. The JFCB for this COMTAB entry is altered so that the data set name 
is the same as that of the VToOC data set (X'0404......'). 


Sequential Device 


Dynamic storage is acquired and formatted to describe a sequential data set. 
The JFCB is read into storage and modified for the bypassing of label 
processing. 
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Staged Device 


storage is established for the staged I/O DCB, it is formatted for either an 
input or output direct-access data set, depending on the settings of CTFLAG2 
bits 3 and 4 The IOB for staged I/O is a dummy IOB (STGCON) and is used as 

a parameter area by the staged I/O processing modules. It is formatted by 
the open routine according to the DOS device type. Fcr more information on 
the staged I/O dummy IOB, see the staged I/O routine (IIVSTG). If the DCB 

was initialized to reflect an output data set, the open operation is performed 
within the staged I/O portion of the open routine; otherwise, the common open 
for input issues the open request. 


When module ITVOPN is entered to open a staged printer, print overflow 
processing is invoked. Module IIVOPN loads the correct FCB image from 
SYS1.IMAGELIB and calls module ITIVSTG to verify the image format and content. 
If module TIVSTG returns a unit check in the staged IOB CSW, an invalid FCB 
image has been obtained and emulation is terminated. If the SYS1.IMAGELIR 
data set could not be opened, the open routine issues a WTOR (IIVO4OD) to let 
the operator decide whether to continue without printer overflow support. 


Teleprocessing Device 


Dynamic storage for a DCB is acquired and formatted to describe a sequential 
data set. 


common Open 


A common open operation for input is executed for most types of open requests 
by this portion of the open routine. Tf the data set (file) is opened 
successfully, this subroutine flags the COMTAB entry (CTFLAG=X'01'). If the 
open operation terminated unsuccessfully, an error code is returned to the 
caller in register 15. X*'04' indicates a successful open, and X')0' indicates 
an error in opening the device. 


When a direct-access device other than a staged T/O device is opened, the open 
routine issues an EXCP to read the format 4 DSCB record from the VTOc. This 
EXCP also allows the SIO appendage to extend the DEB extents. By analyzing 
the format 4 DSCB, the open routine determines whether the VT0C overlaps 
cylinder boundaries and issues a message if it does. This subroutine scans 


the vroc for OS password data sets and does not permit use of volumes containing 


such data sets. 


OS PUB Table Build Routine (TIVPUR) -- Flowcharts 6A-6F 


This routine mavos DOS I/O control blocks to OS I/O control blocks Ey means 
of the Emulator OS PUB table. (Storage is obtained by module IIVGET.) An 
OS PUB table entrv points to a COMTAB entry, which contains addresses of OS 
control blocks needed for I/O operations. 


This routine checks the DOS PUB table for a match of each COMTAB entry in the 
DOS channel and unit address field. If a corresvonding DOS PUB table entrv 
is not found, the Emulator is terminated. When a DOS PUB table entry for a 
COMTAB entry is found, the COMTAB entry offset (X'00! for the first 
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entry) is placed in the OS PUB table entry that corresponds to the DOS PUB 
entry. An X'FF' in an OS PUB entry indicates that no COMTAB entry existed 
for a DOS PUB table entry. 
) 


This routine also establishes a pointer to the DOS CE serviceability routines 
if these are surpvorted (the CE table address field in the DOS background 
communications region extension points to these routines). Tf the timer 
function was requested by the user and is supported by DOS, the first STIMER 

is issued. The addresses of the DOS background SYSRDR LUB (logical unit block), 
background PIB (program information block), foreqround 1 PIB, foreground 2 

PIB, and beginning and ending addresses of the DOS 3-transient area are 
obtained. These addresses are adjusted to true addresses and saved in ITVCON, 


If an abbreviated rrompt was requested by the user, the one-line initial 
Emulator prompt is formatted and issued. Otherwise, the standard three-line 
initial Emulator prompt is given. 


Tf the Emulator JCL indicated a need for direct+raccess volume sharing or indexed 
sequential data set sharing, Emulator modules IIVDVS, TIVGR2, IIVVIO, and TIIVIS 
are loaded. 


Tf the shared DOS system residence option has been selected, the address of 
the cylinder used for DOS labels is saved in EMUCONS. 


IIVPUB exits to the caller (IIVSVC). 


GETMAIN/FREFEMAIN Routine (IIVGET) -~= Flowchart 7A 


This routine performs OS GETMAINS and FREFMAINs. 


GETMAIN 


The caller provides IIVGET with the amount of storage needed. The OS GETMAIN 
macro is issued and the return codes checked. If storage was successfully 
obtained, this routine returns to the caller with the new storage address in 
register 1. If dynamic storage was unavailable, a message is issued to the 
console printer and emulation is terminated. 


FRFEMAIN 


The caller provides IIVGET with the amount of storage (register 0) and the 
address of the first byte of the storage (register 1) to be freed. IIVGET 
issues an OS FREEMAIN macro and returns to the caller. 


For all errors during a GETMAIN or FREEMAIN operation, other than storage not 


available, the operating system terminates the Emulator with a system completion 
code. 


Program Check Executive Routine (IIVPCE) -- Flowcharts 8A-8U 


All program interruptions that occur in the DOS area are routed to this routine. 

Upon entry, the 16 DOS general registers are saved in the EMUCONS Save area 

and program addressability is established. : 
a 


54 DOS Emulator Logic 


C 


A check is made for a privileged operation interruption code in the current 
DOS PSW. When the program interruption is caused by an attempt to execute 
a privileged operation, control is passed to PCPRIVOP for further checking. 


The first program interruption during IPL is intercepted, and control is passed 
to the FIRSTPC subroutine for processing. All other program interruptions 

are handled by a routine that causes the DOS current (local @xecution) PSW 

to be moved to the DOS program old PSW (location 40 in the DOS area) and the 
DOS program new PSW (location 104 in the DOS area) to be moved to the DOS 
current (local execution) PSW location to simulate a program interruption. 


At the common exit point for all simulation routines (PC20), the routine loads 
the address of the Emulator asynchronous interrupt exit routine and exits to 
that point. A reentry point (PC10) for program interruption simulation is 
provided. 


FIRSTPC Subroutine (Flowchart 8A) 


TO simulate the program interruption that normally occurs while main storage 

is being set to binary zeros during DOS supervisor IPL, module IIVIN2 places 

a 0 operation code in the DOS routine that performs this function. The 
resulting program interruption is the first one to be intercepted by the program 
check executive routine. 


When given control, this subroutine checks for an operation exception 
interruption code in the current PSW; if the check is negative, control is 
returned to the program check executive routine at PC10 to simulate the program 
interruption. Otherwise, the interruption code is changed to addressing, the 
ending address of DOS main storage is placed in register 11 of the EMUCONS 

DOS register save area, and the FRSTPC bit in the IPLSW switch is set to 0. 
Control is then returned to the program check executive routine (entry point 
PC10) to simulate the program interruption. 


PCPRIVOP Subroutine (Flowchart 8A) 


All privileged operation interruptions are checked to determine if they are 

to be simulated. For such an interruption to qualify for simulation, the local 
execution PSW must show the DOS partition to be operating in the supervisor 
state (see Note in "Privileged Operation"), and the privileged operation must 
be one of the following which are either supported or bypassed by the Emulator. 


LCTL ~ Load control, operation code X*BT7* 
STCTL-~ Store control, operation code X'B6'! 
STIDP- Store CPU ID, operation code X*B202' 
STIDC- Store channel ID, operation code X'B203'! 
SCK - Set clock, operation code X'B204' 


e ISK - Insert storage key, operation code X*'09* 
e SSK - Set storage key, operation code X*08° 

e SSM - Set system mask, operation code X*'80' 

e LPSW - Load PSW, operation code X'82' 

e TCH - Test channel operation code X'9F*t 

e TIO - Test I/0, operation code X*9D*t 

e HIO - Halt I/0, operation code X'9E" (BTAM only) 
e SIO - Start I/0, operation code xX'9c! 

® 

® 

® 

e 

s 


When both conditions are met, control passes to the proper simulation routine. 
If both are not met, the routine exits to the program check executive routine 
(entry point PC10) to simulate a program interruption. 
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The condition code in the local execution PSW is set to 0 and control is passed 
to entry point PC20 if the privileged operation is to be bypassed. Two 
privileged instructions fall into this category; store channel ID (STIDC) and 
set clock (SCK). 


TSK Simulation Subroutine (Flowchart 8C) 


This subroutine simulates the ISK instruction. A branch and link to the FINDKEY 
subroutine is done to get the address of the R1 register of the ISK from the 

DOS register save area of EMUCONS. “he FINDKEY subroutine also gives the 
address of the storage key in the ISK/SSK table for the block represented by 
the address in the R2 register. The storage key is moved from the table into 
bits 24-31 of the R1 register. Control is returned to the program check 
executive routine (entry point PC20). 


SSK Simulation Subroutine (Flowchart 8C) 


This subroutine simulates the SSK instruction. A branch and link to the FINDKEY 
subroutine is done to get the address of the R1 register in the DOS register 
Save area of EMUCONS and the address in the ISK/SSK table of the storage key 

for the block represented by the address in the R2 register. Bits 24-31 of 

the R1 register are moved into the table. Control is returned to the program 
check executive routine (entry point PC20). 


SSM Simulation Subroutine (Flowchart 8C) 


This subroutine simulates the SSM instruction. The address of the new system 
mask is obtained with the FINDADDR subroutine and the byte at the address is 
moved into the first byte of the local execution PSW. Control is returned 

to the program check executive routine (entry point PC20). 


LPSW Simulation Subroutine (Flowchart 8D) 


This subroutine simulates the LPSW instruction. The FINDADDR subroutine is 
used to find the address of the new PSW. The eight bytes of data at that 
address in the DOS area are moved to the local execution PSW. 


Refore the routine exits, a check is made to see if this is the first LPS 
during TPL. If not, exit is made to the program check executive routine (entrv 
point Pc20). The first LPSW during IPL should ke an enabled wait for the TPL 
interruption. Control is passed to entry point INTRPT and the subroutine 
checks the first PSW loaded by the DOS IPL routines. When the wait bit is 

1 and interruptions are enabled, the expected interruption is simulated 
according to the rarameter on the EXEC statement. If these conditions are 
not met, control is returned to the program check executive routine at entrv 
point PC20. When they are met, the first LPSW bit switch in IPLSW is set to 
0 and the interruption type is determined by examination of the DOSIPL 
parameter. 


When DOSIPL=EXT, an external interruption is Simulated. The DOS current (local 
execution) PSW is moved to the external old PSW (location 24 in the DOS area), 
and the external new PSW (location 88 in the DOS area) is moved to the local 
execution PSW location. 
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When the DOSIPL value contains a DOS channel and unit address, that address 

is moved to the interruption code portion of the local execution PSW and an 

I/O interruption is simulated. The local execution PSW is moved to the I/0 

old PSW (location 56 in the DOS area), and the I/0 new PSW (location 120 in 

the DOS area) is moved to the local execution PSW location in the local 
execution list. The CSW is set to 0 and the device end bit is turned on. 

If the DOSIPL device is the DOS console, the attention bit in the CSW is also 
turned on. Control is returned to the program check executive routine at entry 
point Pc20. 


TCH Simulation Subroutine (Flowchart 88F) 


This subroutine simulates the TCH instruction. The FINDCHAN subroutine is 
used to obtain the channel and unit address from the instruction and the index 
and absolute address of the first device entry on the channel in COMTAB. 


The CTFLAG device busy bit in COMTAB is tested to see if any of the devices 

on the channel are busy. If none are found to be busy, the condition code 

in the local execution PSW is set to 9 (channel available). If one is found 
to be busy, the NOP issued bit in CTFLAG3 is tested to determine if a device 
end status is being awaited. If this bit is set, the next device is checked 
for a busy condition; otherwise, the condition code is set to 2 (channel busy). 
Control is returned to the program check executive routine at entry point PCc20. 


TIO Simulation Subroutine (Flowcharts 8F=-86G) 


This subroutine simulates the TIO instruction. The FINDCHAN subroutine is 
used to obtain the channel and unit address from the instruction and the index 
and absolute address of the first device entry on the channel from COMTAR. 


The COMTAB entries are scanned, starting with the first device on the channel, 
for the device being tested. If no match is found, the condition code in the 
local execution PSW is set to 3 (device not operational). When a match is 
made, a further test for device operational is made by testing the 
nonoperational Fit in the CTFLAG byte of COMTAB. If it is 1, the device is 
not operational and the condition code is set to 3. 


The CTFLAG device busv bit in COMTAB is tested for a value of 1 to determine 
whether it is busy. When the bit is 0, the device is not busy unless the 
device is a 2321 DASD unit {all 2321 bins used by DOS must be checked). “hen 
the device is not a 2321 or all bins are not busy, the current PSW condition 
code is set to 0 (device available). When the device is busy, further testing 
is required to determine if an interrurticn is pending. 


The first check for interrupt pending is made on the EC3 comoletion code. 

During IPL, the ECP is waited upon if it has not already been posted in order 

to save going through a TIO loop until T/O completion. Other times, the pending 
I/O table is scanned for an entry for the device. If the I/9 is not complete, 
the local execution PS" condition code is set to 2 (device busy). 


When an I/9 aperation has been completed, the ECR code, the COMTA® index, and 
the address of the device entry are passed to the check subroutine (at entrv 
point CHECK2) to get the stored channel status word. TJpon return, the condition 
code is set to 1 (CSW stored). 


Control is returned to the program check executive routine at entry point PC20. 
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HIO Simulation Subroutine (Flowchart 874) 


intercepted. The routine simulates the 4YIO instruction to DOS. The FINDCHAN 
subroutine is used to obtain the channel and unit address from the instruction 
and the index and ahsolute address of the first device on the channel from 
COMTAB. 


This routine receives control when the privileged operation code HIO is } 


The COMTAB entries are scanned, starting with the first device on the channel, 
for the device being tested. If no match is found, the condition code in the 
local execution PSW is set to 3 (device not operational). When a match is 

made, the routine tests the nonoperational bit in the CTFLAG bhvte of COMTAB. 

TF i+ is 1, the device is not operational and the condition code is set to 

3. The CTFLAG device busy bit in COMTAB is tested for a value of 1 to determine 
whether it is busy or not. If the device is active, a halt I/O operation is 
performed. 


This routine returns to the calling routine at the address specified in the 
return register of the calling routine. The return register is increased by 
a value that determines the proper branch instruction ina hranch table. The 
calling sequénce is as follows; 


e Device not operational - Return to the program check executive routine 
at entry point PC290. 


e Device not busy (flagged 'not in uset by the Emulator) ~ Set CSW status 
to 0, set current (local execution) PSW condition code to 'CSW stored,' 
and return to the program check executive routine at entrv point PC29. 


STO Subroutine (Flowcharts 8J-8N) 


The SIO routine issues an OS EXCP macro for the intercepted DOS SIO. DOS CCWs 

are used, the addresses being adjusted from local to true addresses. The STO 
routine is given control by the program check executive routine when the J 
privileged operation code is recognized as SIO. 


The proper COMTAB entry is selected. (The COMTAB entries contain the various 
Emulator parameters requir2d for each device.) Normrally, the entry is found 
hv means of DOS register 3, which contains a pointer to the appropriate DOS 
PUB entry at SIO. The position of the current PUB in the DOS PUR table is 
used as an index to an OS PUB table created in the Emulator's initialization 
phase. The indexed OS PUB entry contains an index of the proper COMTAB entry. 


During IPL, before the DOS PUBs exist, and for CFE serviceability routine 
operations (where DOS register 3 does not point to a PUB entry), the COMTAR 
entry is determined by a search for channel and unit address in COMTAR. The 
cuu is found by the FINDADDR subroutine. The DOS CAW local address is adiusted 
to its true address. 


If the device is a 2321 Data cell Drive, the COMTAB entry, determined as 
described above, is for the highest defined DOS bin number. The entry for 

the actual bin nurber to be used is determined by a search of all COMTAPR entries 
having the same DOS cuu for the bin number contained in the DASD seek address. 
If a seek does not precede the channel frogram, the address of the last 2321 
COMTAB entry for the device is loaded from its save position in the last COMTAB 
entry. 


DOS is given a condition code of X'00' wless the device is busy (X'02') or 
the device is flagged as not operational (X'03'). If the data set has not 
been opened, the open routine (IIVOPN) is called. 


If the device is a staged I/O device, the SIO count is increased and control 

is passed to module ITVSTG. If the device is DOSLOG, control is passed to 

module IIVLOG. If the I/O request was for a shared OS indexed sequential data 

set, the ECB in the associated ISBLK is posted and a branch is made to STIOCNT. > 
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For direct-access I/O operations, the SEEKTEST subroutine is called to determine 
if the CCW operation code is seek. This routine also moves the correct DCB 
address from the COMTAB extension to the IOB for shared volumes (see SEEKTEST 
subroutine description for further details). The seek address is then moved 

to the IOB. The initial CCW sequence of SEEK-TIC or SEEK-S®T FILE MASK-TIC 

is bypassed. That is, the IOB CCW start address is set to point to the address 
immediately after these commands. 


For direct-access devices only, flags are set for the stand-alone sense 
operation or the stand-alone seek, since these commands do not have their 
addresses adjusted to true addresses by IIVcCCW and, hence, must not be 
readjusted when the I/O interruption occurs. The stand-alone seek is not 
passed on to OS, but is posted complete to DOS. That is, the ECB is posted 
complete and the IOB CSW is posted. 


For tape operations, the DOS initial SET MODE, if present, is moved to a save 
area in the device's COMTAB entry. This is necessary so that the DOS set mode 
opcode can be moved to the OS DEB. The CCW addresses are adjusted to true 
addresses beginning with the CCW immediately after these initial CCWs. If 

a rewind-unload is issued by DOS, an tintervention required't message is printed 
by the Emulator if any further I/O is requested on that tape drive. 


Module IIVccW is called to adjust CCWs. The IIVccwW routine returns to the 
address in register 14 plus 0 (error) or 4 (normal). The error return indicates 
that an error condition was detected during CCW adjustment. The program check 
bit is set in the COS CSW status, the condition code is set to 'CSW stored’, 

and a return to entry point PC20 is made. 


SEEKTEST Subroutine (Flowchart 8k) 


This subroutine gains control to determine if the operation code of a DASD 
ccw is seek. If it is found to be seek, the address of the DASD seek is 
returned to the caller. Control is returned to the caller. 


SEEKDVS Subroutine (Flowchart 8P) 


The DASD seek address is then compared with each lower and upper read or write 
track address in the DEB. If the seek address does fall within a set of DEB 
extents, the associated DCB address is moved from the COMTAB extension to the 
IOB and control is returned to the caller. Otherwise, the next COMTAR extension 
is checked. If no match is found, control is qiven to module IIvVvIo to 
determine whether the seek (and channel program) is for a DOS access to VOL1, 
Fl, or F3. YIVVTIO returns a condition code of 0 when the I/O has to be issued, 
a condition code of 4 when the I/O has to be simulated, or a condition code 

of 8 when the seek address is invalid. In the last case, the routine exits 

to the exit-ABEND error routine (TIVABN) after issuing the INVALID SEEK messaqe. 


FINDCHAN Subroutine (Flowchart 80) 


This subroutine is used by the TCH, HIO, and TIO instructions to obtain the 
channel and unit address, the device entry index into COMTAB, and the absolute 
address of the device entry in COMTAB. The channel and unit address is obtained 
from the FINDADDR subroutine and stored at CHANUNIT in EMUCONS. The channel 
number is used to index into the CHNINDX table to determine whether the channel 
is supported hy the Emulator. When the channel is not supported, the condition 
code in the local execution PSW is set to 3 (not operational) and exit is made 
to the program check executive routine entry point PC20. 


Method of Operation 


De) 


The index into COMTAB for supported channels is obtained from the CHNINDX table 
and multiplied by the COMTAR entry length. The result plus the starting address 
of COMTAB is returned to the caller in register RW4FU. The channel index value 
is returned in register RWOEU. Return is to the address in register RBOCN. 


FINDADDR Subroutine (Flowchart 8R) 


This subroutine is used to determine the absolute value of the BIDD portion 

of a DOS privileged operation instruction. The base register bits are used 

as an index to locate the register value in the register save area. The 1 
1/2-byte displacement value is added to the value contained in the register 
save area to okttain the effective address. If the instruction has an I/O code 
(T™ for X'9C'), the address adjustment factor is not added; it is in all other 
cases. The resulting value is returned in register RW2EU and return is made 
to the caller bv a branch to the address in register RLOEU. 


FINDKEY Subroutine (Flowchart 8S) 


This subroutine analyzes the ISK or SSK instruction to obtain the address of 
the R1 register in the instruction and the address of the entry in the ITSK/SSK 
table that corresponds to the address value in the ®2 register. When a main- 
Storage address larger than the DOS area is specified in R2, an addressing 
program interruption is simulated. 


The address of the R1 register is returned in register RWHYEU and the address 
of the 1-byte entry in the ISK/SSK table is returned in register RW3EU. 


Load/Store Control Register Subroutine (Flowchart 8T) 


The two instructions (load control and store control) are simulated only to 
the extent that control register information is preserved in EMUCONS for 
retrieval by DOS. 


Load Control Register. Control register information (starting at the DOS main- 
storage address specified in the LCTL instruction and continuing through as 
many storage words as the number of control registers specified) is moved into 
the control register field labeled CTLREGS in EMUCONS. 


Store Control Register. Control register information is moved from the control 
register field labeled CTLREGS in EMUCONS to the DCS main-storage address 
specified by the STCTL instruction and continuing through as many storage words 
as the number of control registers specified. 


Store CPU ID Subroutine (Flowchart 8S) 


Eight bytes of CPU identification information are moved from a field (labeled 
CPUID) in EMUCONS to the DOS main«storage address specified in the STIDP 
instruction. The CPUID field in EMUCONS is initialized by the Emulator start 
I/O appendage. 
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Set Clock Subroutine (Flowchart 81) 


The Emulator set clock subroutine gains control when an SCK instruction 
(Operation code is X'B204') is executed by DOS. This routine has two major 
functions: 


° Compute and save in EMUCONS the absolute value of the difference between 
the OS time-of—day clock and the value addressed by the SCK instruction 


° Locate and invalidate the STCK instruction {store clock) in the DOS Svc 
34 routine. The main-storage address of the STCK instruction is saved 
in EMUCONS so that the program check (operation exception) can later be 
identified as the STCK instruction. No action is taken if the STCK 
instruction is not found. 


Control is passed to entry point PC20 in TIVPCE for return to DOS. 


Store Clock Subroutine (Flowchart 80) 


The Emulator store clock subroutine gains control after the program check 
caused by the DOS invalidated STCK instruction occurs. The address contained 
in the operation pointer field in the local execution list is compared with 
the address saved in EMTICONS by the set clock subroutine. A program check 
will be passed back to DOS if these addresses are not equal. 


An &-byte field in FMUCONS labeled TDELTA will contain the absolute value of 
the difference between the OS time-of-day value and the DOS time-of-day value. 
A switch labeled S370SW (in EMUCONS) will have bit 4 set to one if TDELTA is 
to be subtracted from the OS time-of-dav value. The result is stored in DOS 
main storade addressed by the STCK instruction. Control is passed to entry 
point PC20 in IIVPCE for return to DOS. 


Check I/O Routine (ITVCHK) -- Flowcharts 9A-9D 


The main function of this routine is to post the DOS CSW when an I/0 
interruption occurs. The information posted is obtained from the IOB CSW. 


The routine receives ccentrcel from module ITVRTE when an outstanding posted 
I/O interruption is recognized. The routine is also entered by the TIO 
Simulation subroutine (module ITVPCE) to post the LOS CSW. 


The routine readjusts the CCW addresses to their local values. This is not 
required for onerations flagged by module TIVPCE at STO as being a stand-alone 
sense or seek. 


For the shared DOS residence option, a DOS read to record 1 of the DOS svstem 
directory (CCRHR=X'0000000101') will cause the DOS lakel cylinder address to 
be moved from EMUCONS to the related field in the COS input area. This is 
done to ensure that the proper label cylinder is being accessed. 


For BTAM devices, the CCW chain issued is tested to determine if it is the 
chain used in polling with an autopcll wrarlist. Tf it is, the fifth and sixth 
(and for start/stop devices, the seventh) CCWs are readjusted without using 
module Itvccw. This is necessary since DOS BTAM modifies these CCW chains, 
causing the readjustment module TIVCCW to lose a path to these commands. 


The routine issues a NOP operation to the device if the operation completes 
normally (completion code X'7F') and a channel-end only has been posted. This 
is performed to obtain device end conditions to be passed to DOS if the NOP 

is intercepted. If it is not intercepted, a CSW with only a device end 
condition is passed to DOS. 
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is performed to obtain device end conditions to be passed to DOS if the NOP 
is intercepted. If it is not intercepted, a CSW with only a device end 
condition is passed to DOS. ) 


For all devices except DOS BTAM, if OS has posted a permanent [/O error for 
other than a rewind-unload operation, the routine posts a high error count 
to DOS to prevent DOS retries. The count is stored in the DOS PUB table. 
For tape, if TEBs are present, the count is stored in the TEB. If no TEBs 
are present, the count is stored in the TEBV if TEBVs are present. 


For rewind-unload operations, two situations exist. In one case, an Operator 
intervention is required, in which event the Emulator again issues a NOP as 
it does to force device end. The object of this NOP is to force OS to wait 
for the device to be readied, which will result in the Emulator simulating 
an unsolicited device end to DOS. The FPSW flag is on to indicate this 
Situation. In the other case, intervention may not be required at all; 
therefore, the Emulator arbitrarily simulates an unsolicited device end to 
DOS. This is done as DOS has no indication of an actual unsolicited device 
end and may be waiting for one. The DEON flag is turned on to indicate both 
situations and the simulated interruption is queued in the post ECB list. 


The routine transfers control to module IIVABN to post a channel end program 
check to DOS if module IIVCCW returns indicating an invalid CCW. This causes 
DOS to cancel the partition in which the error occurred. 


Interpretive SYSLOG Routine (IIVLOG) -- Flowcharts 10A-10E 


This routine interprets IBM 1052 Printer Keyboard CCW chains and issues WTO 

or WTOR as required by the channel program. All alarm commands are translated 

to NOP. Both data and command chaining are supported. Control is passed to 

this routine by the program check executive routine (ITVPCE). ) 


Initialization 


The dummy IOB for SYSLOG and the codes and flags used by the routine are 
initialized. The CAW verification routine (IIVAWV) and CCW verification routine 
(IIVCWV) are called to validate the DOS CAW and CCWs, respectively. If the 

CAW or a CCW is invalid and it was the first CCW of a chain, the PSW condition 
code is set to 01 and control is given to the exit subroutine. If the CAW 
and/or CCW is valid, the command code is validated and translated to an index 
value to be used with a branch table to go to the proper processing subroutine. 
The index values are: 


00 Invalid command code 


O04 - NOP/alarm 
08 - Sense 
10 - Write with automatic carriage return 
14 —- Write with no automatic carriage return 
0C - Read 
Invalid Command Code. This subroutine sets either the command reject bit in 


the sense byte and the unit check bit in the status byte or, if the 4 low-order . 
bits of the command code are 0, the program check bit in the status byte. > 
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NOP/Alarm. If the CCW is the first in a chain, the PSW condition code is set 
to 01. Control is given to the exit subroutine, bypassing the first CCW check 
in exit. 


Sense. The sense byte is moved to the data area specified in the CCW and 
control is given to the exit subroutine. 


Read. If a previous WTO is still outstanding, the WTO message is moved to 

the output area of the WTOR. The total reply length is obtained from the CCW 
and placed in the output area of the WTOR. The WTOR is then issued, the route 
Switch is set on, and control is passed to the asynchronous interrupt exit 
routine (IIVRTE). 


When the ECB associated with the WTOR is posted, control is passed to the 
remainder of the read subroutine. The reply is moved to the storage area 
specified by the data address in the CCW. If a continuation was requested 

in the reply, the data address and reply length are modified and control is 
passed to the read subroutine to issue another WTOR. If the reply is complete, 
control is passed to the exit subroutine. 


Write. Tests are made to determine if data chaining or no automatic carriage 
return was specified in the previous CCW. If not, and the previous CCW was 

a write, the previously assembled WTO is issued. After the length and addresses 
of the current message are determined, a check is made to see if the length 

is greater than the maximum allowed for a WTO. If so, the message is broken 
into successive WTOs until the length of the remaining message is less than 

or equal to the maximum. One pending WTO is always left. Control is then 
passed to the exit subroutine. 


Exit. If the CCW is the first in a chain, the PSW condition code is set to 
00. The sense byte is cleared for the next command and the CCW address is 
increased to point to the next CCW. 


e If the current chaining flags are on, control is returned to the 
initialization subroutine at the point where module IIVCWV is called. 


e If no chaining flags are on, the device end and channel end bits in the 
status byte are set on. 


e If a WTO is pending, the WTO is issued. 


e If the route switch is on, the SYSLOG interruption pending flag is set 
on and control is passed to entry point IIVRTER2 in the route routine. 


° If the route switch is off and the PSW condition code is 00, the SYSLOG 
interruption pending flag is set on. 


e If the PSW condition code is 01, the DOS CSW is posted. 


The routine exits to the asynchronous interrupt exit routine (ITIVRTE) at entry 
point ITVRTER2. 


Control will be returned to the IIVLOGR1 or IIVLOGR2 subroutines by the select 
routine if the SYSLOG interruption pending flag is on. 


Dummy SYSLOG I/O Interruption 


Control is passed to the IIVLOGR1 or the TIVLOGR2 subroutine by the Select 
routine (IIVRTESL) when the SYSLOG interruption pending flag is on. 
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The SYSLOG interruption pending flag is set off, the DOS CSW is posted, and 
the DOS I/O interruption action is performed. Control is passed to the 
asynchronous interrupt exit routine (IIVRTER2). ) 


Staged I/O Routine (IIVSTG) -- Flowcharts 11A-11N 


Module IIVSTG contains the main logic required to stage input and output 
devices. During Emulator initialization, an IOB for each device defined in 

a DD statement is created. In the case of staged I/0, this area contains 
information that describes the unique characteristics of the device being 
staged, that is, print size, valid command codes, etc. This area also contains 
Switches that indicate the function to be performed. (See STGCON in 'Data 
Areas't for format.) 


Module IIVSTG receives control from module IIVPCE at DOS SIO. The contents 
of all registers are saved, and the channel status word in STGCON is reset 
to 0. STGSEN1 is moved to STGSENO and set to 0. STGSENO is given to DOS 
whenever a sense command is issued. 


IIVAWV is called to validate the DOS CAW and initialize the CCW pointer in 
STGCON (STGCCW). Module IIVAWV sets the program check bit in the CSW contained 
in STGCON if it encountered any errors. VWpon return from IIVAWV, a test is 
made to see if the program check bit was set. If it was, the CSW in STGCON 

is moved into location 64 in DOS storage, the condition code in the local 
execution PSW is set to CSW stored (01), and control is given to IIVRTER2. 


If no errors were encountered, IIVCWV is called. This module checks the 

validity of the CCW addressed by STSCCW in STGCON. If the CCW is a TIC, the 

CCW pointer (STGCCW) is altered to point to the CCW addressed by the TIC. 

If any errors are encountered, the program check bit is set in the CSW contained 3 
in STGCON (STGCSW). Upon return from IIVCWV, a test is made to see if the ‘ 
program check bit was set. If it was, the following action is taken. 


1. If the erroneous CCW is the first CCW in a chain (the CCW addressed by 
the CAW), the CSW is moved from STGCON to location 64 of DOS storage. 
The condition code in the local execution PSW is set to CSW stored (01), 
and control is given to IIVRTER2. 


2. In all other cases, a hexadecimal 7F is moved into the high-order byte 
of the ECB for the device being staged. The pending interruption is later 
given to DOS in the same manner as for nonstaged devices. Control is given 
to IIVRTER2. 


If no errors were discovered by IIVCWV, the data chaining bit is checked in 
the DOS CCW. If it is set, the program check bit is set in the CSW in STGCON 
and the same action is then taken as if the program check bit were set by 
module TIVcCWV. 


If the 4 low-order bits of the CCW command code are 0, the program check bit 
in the CSW is set to 1 and control is passed to IIVRTER2. Otherwise, the CCW 
operation code is translated according to the translate table whose address 

is contained in the STGOPCD field in STGCON. If the result of the translation 
is 0, the unit check bit in the CSW is set, the command reject bit in the 
current sense byte in STGCON (STGSEN1) is set, the ECB for the device being 
staged is posted, and control is given to IIVRTER2. 


If the CCW command code is valid, it is checked for being a sense command. 

If it is a sense command, the sense information is taken from STGSENO and moved 

to the address contained in the DOS CCW plus the adjustment factor. STGSENO 

is then set to 0. If no errors were encountered up to this point, the command 

chaining bit is checked. If it is set, STGCCW is increased by 8 and the next 
ccW is processed. (If it is not set, refer to "Staged Output.") 2 
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If the command code is NOP, the command chaining bit is checked, If it is set, 
STGCCW is increased by 8 and the process is repeated for the next CCW. 


STGMAX in STGCON contains the maximum number of bytes that can be transmitted 
to or from the unit-record device that is being staged. If the count field 

in the DOS CCW contains a value greater than the value in STGMAX, the residual 
count is computed and stored in the residual count field in the CSW. The 
incorrect length bit is also set in the CSW in STGCON if the SLI bit in the 
CCW being processed is not set. 


Staged Input 


If the first command to a staged reader is a feed~-stacker select, the unusual 
sequence bit in STGSEN1 in STGCON is set (to simulate hardware procedures), 

the unit check bit is set in the status portion of the CSW in STGCON, the ECB 
for the device being staged is posted, and control is given to IIVRTER2. The 
same thing is done for any unusual sequence of commands. Successive commands 
specifying read without feed cause the same input record to be passed to DOS, 


If EODAD (bit 5) in STGFLG is set, a /& is generated within the DOS input area 
and EOD is set in STGFLG to pass back a unit exception for the next input 
request. A GET is issued using get locate mode. A test is made for the SYNAD 
flag in STGFLG to see if there was a permanent error. If there was an error, 
the unit check bit is set in the CSW in STGCON and control is given to IIVRTER2. 


If there were no errors and the suppress data transfer bit in the CCW is set, 
no data is moved into the DOS input area. Otherwise, the number of bytes 
specified in the count field of the CCW or STGMAX, whichever is less, is moved 
into the DOS input area. The first 2 bytes of the input data record are saved 
in STGDLM in STGCON. The EODAD subroutine uses this information to determine 
whether to generate a /*, /&, or both before sending back a unit exception. 
Control is then given to STGIO110 to check for command chaining. 


Staged Output 


If the output device being staged is a printer, the initial output request 
causes a skip-to-channel-1 command to be issued, followed by the DDname of 

the data set being written and by another skip to channel 1. If the device 

is a punch, the stacker bits in the command address portion of the CCW are 
examined to determine whether that particular stacker has been selected during 
this emulation run for the device being staged. If not, three separator cards 
that contain the DDname of the data set being staged are written before the 
output request is staged. 


Print commands for the 3525 punch are compared with the last print command 
issued by DOS. Control is given to CMNDREJ if the line number indicated in 
the current command is not greater than the line number in the last command, 
otherwise, the last print command field in STGCON (labeled STGLCMD) is updated 
with the current print command. 


The DCBLRECL field of the DCB is modified to reflect the length of the current 
output record. A PUT is issued and the buffer address is obtained from register 
1. The SYNAD bit in STGFLG is tested to determine whether a permanent I/0 

error had occurred. If this bit is set, the unit check bit is set in the 

status portion of the CSW in STGCON and the device not operational bit (X'02"*) 
is set in the CTFLAG field of COMTAB. This, in effect, causes the DOS device 

to be permanently disabled for the remainder of the Emulator run. If no I/0 
error had occurred, the record descriptor word in the output buffer (which 
contains variable length records) is set with the value that was placed in 
CCBLRECL. 


Method of Operation 


If the staged device is a printer and if module IIVPOV was included during 

the Emulator link-edit, a branch and link to that module is issued to simulate 

the carriage tape operation normally performed by the printer. This routine 

aids DOS printer overflow by simulating channel 9 and 12 interruptions to DOS. ) 


When control is regained from IIVPOV, the status portion of the CSW in STGCON 
is tested for unusual conditions that might have occurred, such as unit check 
Or incorrect length. 


If any unusual conditions had occurred or if no command chaining is specified, 
the ECB for the staged device is posted and control is given to IIVRTER2. 

If command chaining is specified, the CCW pointer in STGCON (STGCCW) is 
increased by 8 and the routine starts processing the next CCW in the chain. 


If the FIRSTCCW flag in STGFLG is not set after entry at CSWSTOR, a branch 

to INTPEND is issued. Otherwise, the staged device cuu is moved into the 
interruption field of the local execution PSW. The condition code in the local 
execution PSW is set to 1 (CSW stored). The CCW address is readjusted, 
increased by 8, and stored in the command address portion of the CSW in STGCON 
(address 64). Control is passed to the route routine (IIVRTER2). 


After entry at INTPEND, the address of the last CCW processed is readjusted, 
increased by 8, and stored in the command address portion of the STGCON CSW. 
The condition code in the local execution PSW is set to 0, channel end and 
device end in the STGCON CSW are set, the ECB in COMTAB is posted, and control 
is given to the route routine (IIVRTER2). 


SENSE is entered if the CCW being processed is a sense command (op code X'04#'). 

The SYNAD bit in STGFLG is tested to determine whether a permanent input error 

had previously occurred. (IIVSTG does not receive control after a permanent 

output error.) If the SYNAD bit is set, the unit check bit in the CSW in 

STGCON is set to 1 and the SYNAD bit is reset to 0. This causes an ‘'error- 

on-recovery' condition when DOS regains control, and the DOS problem program | 
that issued the erroneous read is terminated. 2 


If there were no input errors, the residual count is computed and stored in 

the CSW in STGCON. The CCW data address is adjusted by the adjustment factor 
in the local execution list. The simulated sense bvte (STGSENO) is moved to 
the adjusted data address only if the suppress data-transfer bit in the CCW 

is set to 1. The incorrect length (TLC) bit is set in the CSW in STGCON if 

the SLI bit in the CCW is not set to 1 and if there is a residual count greater 
than 0 in the CSW. Control is then given back to the main routine to check 

for error conditions and CCW command chaining (see "Staged Output"). 


After entry at CMNDREJ, the command reject bit (bit 0) in STGSEN1 is set. 
The unit check bit is set to 1 in the status portion of the CSW in the dummy 
IOB area (STGCON). Control is passed to entry point INTPEND. 


Read FCB Subroutine (Flowchart 11L) 


This routine gains control at STGIO300 when a read FCB command is encountered 
by module IIVSTG. The data area is initialized to 0 up to the length specified 
in the count field of the CCW or 180 bytes, whichever is less. The Emulator 
forms-control image is converted to its FCB format, one line image at a time. 
The lines-per-inch flag is set in the first byte of the FCB if it is present 
in STGCHFLG in STGCON; the end-of-forms flag in the last byte of the FCB is 
set if the count in the CCW was equal to or greater than the length, in bytes, 
of the FCB image. The residual count, if it exists, is computed and placed 
in the CSW in STGCON, and the incorrect length bit is set if the SLI bit in 
the CCW is not set to 1. Control is then passed to STGIO110 to check for 
command chaining. 
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Load FCB Subroutine (Flowchart 11M) 


This routine gains control at entry point STGIO200 when a load FCB command 
is encountered at the beginning of staged I/O or when module IIVOPN passes 
it control because an Emulator forms-control image must be created. 


A FREEMAIN is issued to release the main-storage area where the existing image 
resides. A GETMAIN is then issued to obtain main storage for the new image. 


The unit check bit is set in the status portion of the CSW in STGCON and a 
load check is set in the sense byte under the following conditions: 


e The absence of the end-of-forms flag in the last position of the FCB data 
e A value greater than X'0C' in any line position in the FCB data 

The lines-per-inch flag, if present, is saved in STGCHFLG so that when an FCB 
is built by module IIVSTG when a read FCB command is issued, the FCB will be 


identical to that loaded previously. The STGCHFLG, STGCTP, STGLNPTR, and 
STGLNCNT fields in STGCON are reinitialized. Control is returned to the caller 


after the new Emulator forms-control image is built. See the module description 


for IIVPOV for further discussion of forms control. 


EODAD Subroutine (Flowchart 11N) 


This subroutine (entry point EODA) is given control by QSAM when an end-of- 
file (EOF) condition is encountered. 


The STGDLM field in STGCON contains the first two characters of the input 
record from the last read operation. If STGDLM contains a /&, the unit 
exception bit in the status portion of the STGCON CSW is set. The EOD bit 

in STGFLG is set to 1 so that any future input request will result ina unit 
exception condition. The ECB for the device being staged is posted and control 
is given to the route routine (IIVRTER2). 


If STGDLM contains a /*, a /& is generated at the address contained in the 
data address portion of the CCW being processed. The EOD switch in STGFLG 
is then set to 1 and the command chaining flag in the CCW is tested. If no 
command chaining was specified, the ECB is posted and control is given to 
ITIVRTER2. 


If STGDLM contains neither a /& nor a /*, the EODAD bit in STGFLG is set to 
1. (This will cause a /& to be generated during the next input request.) A 
/* is generated at the address contained in the data address portion of the 
CCW being processed. If no command chaining was specified, the ECR is posted 
and control is given to TIVRTER2. 


EODAD contains a secondary entry point (EOF010) used to blank out the DOS input 
area whenever a /* or a /& is to be generated. 


SYNAD Subroutine (Flowchart 11N) 


This subroutine (entry point SYNA) is given control by QSAM when a permanent 
input or output error is encountered. The SYNAD bit in STGFLG is set to 1 
and control is returned to OS. The main routine, in turn, regains control 
from OS. 


Method of Operation 
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CAW Verification Routine (IIVAWV) -- Flowchart 12A 


Module IIVAWV validates the DOS CAW and initializes the CCW pointer in STGCON. 
If the CAW is found to contain errors, the CSW program check bit is set and 
control is returned to the caller. 


The following conditions will cause the program check bit in the CSW to be 
set: 


e A nonzero value found in bits 4-7 of the CAW 
° A command address not on a doubleword boundarv 


e A command address greater than the limit address in the local execution 
list 


The following fields in STGCON may be modified by this routine: 
e The status portion of the CSW maintained for this device (SCSWST2) 
e The CCW pointer maintained for this device (STGCCW) 


e The work byte in STGCON for this device (STGWK1) 


CCW Verification Routine (TIVCWV) -- Flowchart 13A 


Module TIvcwv validates and interprets DOS CCWs for IIVSTG and ITVLOG. Tf 
a CCW is found to be in error, the CSW program check bit is set and control 
is returned to the caller. 


The following conditions will cause the program check bit in the CSW to be 
set: 


° A nonzero value in bits 37-39 of the CCW 

e A TIC as the first CCW (that is, the CCW addressed by the CAW) 
e Two TICS with no intervening CCW 

e A 0 in the count field of non-TIC cCCWs 


° A data acdress greater than the value in the limit address in the local 
execution list minus the count 


e A command address in a TIC greater than the limit address in the local 
execution list 


e A command address in a TIC not on a doubleword boundary 


If the command code in the CCW being interpreted is a TIC, the CCW pointer 
in STGCON (STGCCW) is altered to point to the CCW addressed by the TIC. 


The following fields in STGCON may be modified by this routine: 
e The status portion of the CSW that is maintained for this device (SCSWST2) 
e The CCW pointer that is maintained for this device (STGCCW) 


e The work byte in STGCON for this device (STGWK1) 
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Printer Overflow Routine (IIVPOV) -- Flowchart 14A 


Cc Module IIVPOV maintains the simulated sense byte and status portion of the 
CSW for staged printers. IIVPOV simulates the carriage tape operation that 
is normally performed by the printer during output staging. 


The in-storage, forms-control table defines to the Emulator the presence and 
position of forms-control channels for staged printers. Each entry in this 
table, addressed by STGFCT in STGCON, is a halfword in length. Only the low 
order 12 bits are utilized to represent one of 12 possible channels. Channels 
are ascending from left to right. The pointer is updated according to the 
CCW operation code. Within each entry, a 1 bit indicates a punch and a 0 bit 
indicates no punch. 


Module IIVSTG issues as its first PUT for staged printers a skip to channel 

1. In order to calibrate the forms-control pointer to the printed output, 
module IIVPOV receives control from TIVSTG with a dummy-skip-to-channel-1 
command (only if channel 1 was defined in the FCB). The forms-control pointer 
is initially defined to point to the first entry in the table. The dummy skip 
to channel 1 causes the forms-control pointer to point to the first channel 

1 entry in the table. Each DOS output request thereafter changes the value 

of the pointer. When the pointer reaches the end of the table, it is 
reinitialized and the process is repeated. 


Upon entry, ITVPOV determines whether the operation code indicates a space 
command or skip command. If it is a space command, a branch to entry point 
SPACE is performed. Within SPACE, the line pointer is retrieved from STGCON 
and updated. If it points to the end of the table, it is reinitialized. A 
branch and link to entry point FETCH is performed. RW1EU contains the tape 
image for the current line upon return from FETCH. The image is right-adjusted. 


A test for channel 12 is performed. If that bit is present, the unit exception 
bit is turned on in the simulated channel status word. 


A test for channel 9 is performed. If that bit is present, the channel 9 
indication (bit 7 in the simulated sense byte) and unit check bit in the 
Simulated channel status word is set. 


Multiple spaces are simulated one space at a time. Control is returned to 
retrieve the line pointer again if the command was a double or triple space. 
This process continues until all the spaces are simulated. Control is then 
returned to the main routine. 


If the command code indicated a skip was to be performed, SKIP is entered. 
Within SKIP, the channel number is converted from its binary value to its 
storage format. A 12-bit constant (STGCHFLG) is tested. This constant contains 
a 1 bit if the corresponding channel is present in the in-storage carriage 

tape, and a 0 bit if not. The line pointer remains unchanged if there is a 

skip to a nonexistent channel. If the staged device has the FCB feature, a 
unit check and data check are passed back to DOS. 


A branch and link to FETCH is performed. Upon return from FETCH, RW1EU contains 
the in-storage tape image for this line. The in-storage tape image is compared 
with the channel to be skipped to. Control is returned to the calling routine 
if the two are equal. Otherwise, the line pointer is updated and the next 
entry is checked. This process continues until a match is found. 


Adjust CCW Data Address Routine (IIVCCW) -- Flowcharts 15A-15F 


familiar with the operation of this routine. See System/360 Principles of 


A basic knowledge of the format and function of the CCW is needed to become 
C Operation, GA22-6821, for this information. 


Method of Operation 


The following input information must ke passed to this routine by the calling 
routine: the address of the CCW string to be adjusted, the adjustment factor 
to be used, and the limit address of the emulated DOS program. This data is 
passed through the adjust CCW data address list. (See the Appendix for the 
format and function of this list.) 


This routine adds an adjustment factor to the data address of each CCW ina 
string passed to this routine by the calling routine. When an STO is issued 
by DOS with this string of CCWs, the data addresses in the CCNs will be local 
addresses. The adjustment factor passed to this routine will be positive. 
When this positive adjustment factor is added to the local data addressed in 
the cCWs, these addresses will be changed to true addresses that can be used 
by OS. 


When OS finishes processing the SIO, the same string of CCWs is returned to 
this routine with a negative adjustment factor. When this factor is added 
to the cCW data addresses, the true data addresses will be changed to local 
data addresses that the emulated DOS program can use. 


This routine uses two tables in itsS operation. 


The first is called the beginning and end block (BE3LK) and consists of 30 
8-byte entries. The first 4 bytes of an entry contain the true beginning 
address of the continuous group of CCWs in the CCW string being adjusted. 
The second 4 bytes contain the true end address of the continuous group of 
cCWs. The first bit of each entry is used as a completion indicator to show 
whether that grourc of CCWs has been processed. If the bit is 1, the group 
has been processed; if 0, it has not been processed. 


When this routine encounters two different paths in the CCW string being 

processed, it continues processing one path and builds an entry in RBBLY¥ 

indicating which path has not yet been processed. This entrv is called an 

incomplete BEBLK entry. As each incomplete BEBLK entry is created, it is | 
placed in BEBLK, starting at the endjd and working backward. The normal BEBLK ) 
entries start at the beginning of BEBLK and work forward. In the incomplete 

entry, the first 4 bytes are the TIC address, the fifth byte is the operation 

byte, and the last 3 bytes are the operation vointer. All of these values 

are taken from the adjust CCW data acdress list. 


The other table used by this routine is called the status modifier table. 

This is a 256-byte translate and test table that contains the CCW command codes 
for the devices supported by the Emulator that cause the channel to return 

a status modifier condition when a CCWts condition is met. 


Because it is possible to add the adjustment factor to a single CCW more than 
once, this routine uses a two-step method to adjust the data addresses in the 
CCW string. It is possible to add the adjustment factor more than once because 
the CCW string uses a CCW more than once in performing its operation. 


During the first step, this routine adjusts the data address portion of each 
ccW in a string of CCWs with an adjustment factor of zero. This is done so 
that BEBLK entries can be created for each contiguous grouv of CCWs in the 
ccW string. As each BEBLK entry is created, this routine will branch to the 
combine subroutine to have duplicate groups of CCWs eliminated from BEBLK. 


After the entire groups of CCW string has been processed and all duplicate 
qroups of CCWs have been eliminated from BEBLK, the second step of this routine 
is performed. The data addresses of the CCWs defined by each entry in the 
BEBLK table are adjusted. The CCWs within each group that is represented bv 

a BEBLK entry have their data addresses adjusted by an adjustment factor that 
is passed by the calling routine. Therefore, if this adjustment factor is 
positive, the CCW data addresses are changed from local to true addresses; 

if the adjustment factor is negative, the CCW data addresses are changed from 
true to local addresses. 
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If anv addressability, protection, or specification errors are detected by 
the adjust CCW string instruction or BEBLK is filled, this routine returns 
control to the calling routine's return point. 


Tf the byte count of a CCW in the CCW string being processed by this routine 
is added to the true address created for that CCW by this routine and the 
resultant address exceeds the emulated DOS program's limit address (passed 
to this routine by the calling routine), the SLI bit in this CCW is tested. 
If the SLI bit is on, this routine assumes that the storage area addressed 
by this CCW will not exceed the emulated DOS rvrogram's storage area and 
continues processing this CCW string. 


Upon normal completion of this routine's operation, control is returned to 
the address 4 bytes beyond the calling routine's return point. 


This routine sets the ABEND interception switch before adjusting CCWs. It 
then resets the switch after the adjustment is complete. If the ABEND 
interception is taken, the caller's registers are restored and control is 
passed to IIVAB4. At this time an ABEND error code of 16 is set in register 
1 and control is returned to the caller. 


Combine Subroutine (Flowchart 15F) 


This routine eliminates any duplicate CCYs from the BEBLK table by combining 

an entrv with a beginning and/or ending address that falls within the beginning 
and/or ending acdress of another entry, into the same entry. The routine also 
tests the last CCW of the current BEBLK entry to see if it is a TIC. If it 

is a TIC, this routine tests all BEBLK entries to see if the "fC command address 
is in BEBLK. 


If this routine is able to combine the current BEBLK entry into any of the 
other entries, it turns the combine switch on to indicate to the calling routine 
that it has done so. 


Tf this routine found the TIC command address in BEBLK, it turns the TIC-TO 
switch on to indicate to the calling routine that the TIC command address has 
already been proc2ssed by the adjust CCW data address routine. 


If this routine is able to combine the current BEBLK entry into BERBLK, the 
ccW string being adjusted has lcoped into an area of itself that has alreadv 
been processed. If this cccurs and there are no incomplete paths of the CCW 
string to be processed, the theoretical end of the CCW string being adjusted 
has been reached. 


CCW Adjustment Routine (TIVADJ) -- Flowcharts 16A-16B 


This routine gains control from the IIVCCW or JTIVRCW module and returns control 
to the ITVccW or IIVRCW module upon completion of its function. Refer to the 
Appendix (Adjust CCW String Instruction) for a description of the function 

of this module. 


Method of Overation 
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Supervisor Call Routine (IIVSVC) -- Flowchart 17A 


All supervisor calls that originate within the DOS region are 
intercepted prior to the execution of the DOS SVC 
instruction, and control is given to the Emulator supervisor 


call routine (IIVSVC). Upon entry, this routine stores all 
DOS general registers in EMUCONS and establishes 
program addressability. 


When a DOS SVC 0 that meets the 


When the first DOS SVC 4 is intercepted, After first following conditions is intercepted, 

this routine modifies the DOS IPL DOS SVC 4. | IIVSVC gives control to the Emulator —_| weets 
monitor switch (IPLSW) in EMUCONS Before first automatic IPL routine (IIVADD), requirements 
to indicate that DOS IPL phase DOS SVC 14.] which builds DOS IPL control state- 

$$A$IPL2 has completed processing First DOS If AUTO IPL] ments: RC #0 

and DOS phase $$IPLRT2 is in SVC 4 is requested e The DOS SVC 0 was not issued by 


the DOS supervisor. 
* The DOS CCB symbolic unit is for 
SYSUSE. 
¢ The DOS channel program 
operation code is a read command 
(X’02’). 
A O return code from |IVADD requests 
a DOS SVC interrupt to be simulated. 


Not 
qualified 


control. 
A DOS SVC interrupt is simulated for 
DOS. 


A DOS fetch (SVC 2) of $$}BUFLDR 
is bypassed. 

(After first DOS SVC 4 and before 
first DOS SVC 14.) 


If a DOS SVC 1, 2, 4, or 11 is intercepted, 
control is transferred to the Emulator 
DOS SVC monitor (IIVGR2). A 
return code will be passed back from 
IIVGR2. 
Return code = 0: a DOS SVC interrupt 
is simulated to DOS. 
Return code #0: no DOS SVC 
interrupt is simulated and the DOS 
SVC instruction will not be executed. 


After first 
DOS SVC 14 
if volume 
sharing is 
requested, 


The first DOS SVC 14 (EOJ) inter- 
cepted indicates that DOS !|PL is 
finished. The DOS IPL monitor switch 
(IPLSW) in EMUCONS is modified to 
indicate that DOS IPL has completed. 
Control is then transferred to the OS 
PUB table build routine (11! VPUB), 
which validates the OS to DOS unit 
relationship. A DOS SVC interrupt is 
simulated for DOS. 


First DOS 
SVC 14 


Simulate DOS 
SVC interrupt 


After first 
DOS SVC 14 

if volume 
sharing was not 
requested. 


A DOS SVC interrupt is simulated to 
DOS by moving the PSW field from the 
local execution list to the DOS old 
SVC PSW (location 32) in the DOS 
storage area and moving the DOS SVC 
new PSW (location 96) from the DOS 
storage area into the PSW field in the 
local execution list. This means that 
upon return to DOS, the DOS SVC 
will be executed. 


Bypass DOS 
SVC 
orocessing 


The local execution list PSW field is 

left unmodified. DOS receives 

control at the next sequential instruc- 
tion following the DOS SVC instruction. 
The DOS SVC instruction is not executed. 


Return 


Return to DOS via IIVRTE. 
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Start I/O, End-of-Extent, Channel End, and Abnormal End Appendage (IGG019SA) 
-- Flowcharts 18A-18B 


The appendages are used to maintain (modify/restore) the DEBs for DASD and 
tape devices used by DOS. The DEB is built during open in protected storage 
(key of zero); it contains the file mask and extent information for direct- 
access devices and the set mode command for tape devices that are maintained 
by these appendages. 


When the DEB is built by open, the initial entry address is in the DEB appendage 


address table for the start I/O and end-of-extent appendages if the device 

is direct access, and for the start I/O appendage if the device is tape. The 
initial entry modifies the addresses in the DEB appendage address table to 
point to the respective routines within the module. 


The CPU ID is stored when this appendage is entered for the first time. CPU 
ID information will then be obtained from EMUCONS when the STIDP instruction 
is issued by DOs. 


The addresses modified in a DEB are: 


DASD DEB: 

° End-of-extent address - EOERT0O00 
Start I/O address - SIORTOOO 

® Channel end address - CERTOO00 

e Abnormal end address - AERTO00 
TAPE DEB: 


e Start I/O address - STORT500 


After initializing the DEB appendage address table, control is passed to the 
appropriate routine. 


End-of-Extent Subroutine (EOERT0O00 - Flowchart 18A) 


If the user label flag is on in the COMTAB (CTFLAG3 bit 0), the extent 
information in the DEB is saved and replaced with the user label extent from 
the COMTAB. Return is made to OS for a retry of the I/O request. Otherwise, 
the normal return is made to OS, which results in an out-of-extent condition 
to be posted in the event control block. 


Start I/O (Tape) Subroutine (STORT500) - Flowchart 18A) 


The DOS set mode command is moved from the COMTAB to the DEB. 


Start I/O (DASD) Subroutine (SIORTO00 - Flowchart 18B) 


The extent information in the DEB is saved and replaced with an extent limit 
of one cylinder (based on the cylinder in the IOB seek address) so that OS 
cylinder switching at end of extent will be inhibited. If the shared volume 
flag (CTFLAG3 bit 4) is not on, the DOS file mask is set in the DEB. Return 
to OS is always normal. 


Method of Operation 


73 


Abnormal End (DASD) Subroutine (AERT0O00 - Flowchart 18B) 


The event control block in the IOB is tested to see if OS error recovery is 
completed. If not, the normal return is made so OS error recovery will be 
performed. Otherwise, control is passed to the restore subroutine (RSTOR0900) 
to restore the extent in the DEB. 


Channel End (DASD) Subroutine (CERT0O00 - Flowchart 18B) 


The condition code is tested to see if an error condition has been detected 
at channel end. If an error condition is present, the normal return is made 
so OS error recovery will be performed. Otherwise, control is passed to the 
restore subroutine (RSTOR0O00) to restore the extent in the DEB. 


Restore DEB Extent Subroutine (RSTORO000 - Flowchart 18B) 


The extent saved by SIORTO0O00 or EOERTO0O0O is moved into the DEB. The return 
to OS is always normal. 


Abnormal End/Channel End Appendage (1IGG019S1) -- Flowchart 19A 


This Emulator module does double duty as an abnormal end appendage for 
teleprocessing devices and a channel end and abnormal end appendage for tape 
and unit-record devices. 


The abnormal end appendage bypasses OS error recovery procedures for 
teleprocessing I/O errors. When a magnetic tape, unit record, or telepvrocessing 
{(BTAM) error is detected, control is given to the appropriate section of the 
appendage. The apvendage turns off the IOB exception bit and returns to the 

I/O supervisor (0 displacement from the address in register 14) to bypass the 

OS error recovery procedures. If the appendage receives control for an error 
other than those mentioned above, it immediately returns to the I/O supervisor, 
allowing the OS error recovery procedures to handle the error processing. 

The abnormal end appendage also routes error conditions for Emulator-initiated 
I/O (as opposed to DOS-initiated I/0) to the OS error recovery procedures. 


In the role of channel end appendage, this module routes all incorrect length 
and unit exception conditions for tape and unit record devices at channel 

end to DOS. (DOS does not consider incorrect length a permanent error 
condition.) It does this by turning off the exception bit in the IOB and 
returning to the OS I/0 supervisor, which then posts the I/O operation complete. 


After a tape rewind-unload has been issued or a BTAM intervention required 
condition occurs, the not ready bit is turned on in the UCB and a not ready 
flag is set in the COMTAB entry. For unit-record devices, if a unit exception 
occurs, the IOB esception flag is turned off, suppressing OS error recovery 
procedures. 


Asynchronous Interrupt Exit Routine (IIVRTE) -- Flowcharts 20A-20G 


When the OS supervisor has completed processing any asynchronous interruption 
that occurred while DOS was operating in local execution mode, it gives control 
to this routine at entry point ITIVRTE. When this routine finishes processing, 
it returns control to DOS by issuing the execute local instruction which returns 
the CPU to local execution mode. 


If the one-second STIMER interval has expired, this routine branches to the 
timer interrupt check routine to process the interruption. If the interval 
has not expired, the routine branches to the asynchronous interrupt check 
routine to see if any of the Emulator ECBs pointed to by the ECB pointer table 
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are posted. If one or more of the Emlator ECBs are posted, this routine 
branches to the select routine, which passes control to the appropriate Fmulator 
routine to process the interruption. 


If the interruption was not for the Emulator, DOS is checked to see if it is 
in the wait state. If DOS is in the wait state and interruptions are disabled 
(hard wait), control is given to the ABEND error routine (IIVABN) to cancel 
the Emulator job. If DOS is in the wait state and the AUTOEOJ option has been 
specified, control is passed to the end of job routine to see if DOS has any 
more work to do. 


If DOS is in the wait state, this routine goes into the wait state until 
completion of an outstanding I/O operation. When this occurs, control is given 
to the appropriate Emulator routine to simulate completion of the I/O operation 
to DOS. 


If DOS is not in the wait state and the timer option has been specified, the 
fourth byte (local address X'53') of the emulated DOS timer is increased bv 

1. When this byte reaches a value of 256, it is reset to 0. The purpose of 
this operation is to show DOS a constantly changing timer value when the timer 
is tested to see if it is operational. This has no real effect on the actual 
time. 


After the DOS interval timer has been updated, or if the timer option was not 
specified, control is given to DOS through the execute local instruction, thus 
placing the CPU in local execution mode. For an explanation of the operation 
of this instruction, see the "DOS Compatibility Feature" in the Appendix. 


STAE Exit Routine (Flowchart 20A) 


This routine gains control for a scheduled OCS ABEND. The primary function 

of this routine is to determine whether further ABEND processing is to he 
allowed or bypassed. ABEND processing is bypassed only if the bypass ABEND 
switch (OPTFLGR2 in TIVCON=X'02') is on or a //SYSABEND DD statement is present 
in the OS jobstream. The switch is set on by TIVOPN before opening a nonshared 
volume and by IIvccW before CCW address adjustment takes place. The STAF retrv 
routine is scheduled to receive control and the routine returns to the OS ABEND 
processing routines. 


Route Routine (Flowchart 20B) 


The entry point for this routine is IIVRTER2. Following completion of their 
operations, the interpretive SYSLOG (TIVLOG), staged I/O (IIVSTG), asynchronous 
interrupt exit (TIVRTE), and program check executive (IIVPCE) routines return 
to this routine at entry point IIVRTER2 to return control to DOS. The LPSW 
Simulation, SSM simulation, ISK simulation, SSK simulation, TIO simulation, 

TCH simulation, SIO, and Check I/O routines return to the IIVRTER2 entry point 
by means of the program check executive routine. Module IIVRAS also exits 

to LIIVRTER2. 


At entry point IIVRTER2, this routine tests to see if any more interruptions 
can be processed before control is given to DOS. If any further interruptions 
can be processed, control is given to the appropriate Emulator routine. If 
not, control is given to DOS through the execute local instruction. 


Method of Operation 
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Select Routine (Flowchart 20C) 


This routine routes control to the appropriate Emulator routine that handles 
pending asynchronous interruptions of the emulated DOS program. 


The routine first tests to see if the system mask portion of the local execution 
PSW is enabled for external interruptions. If it is, a test is then made to 

see if a timer interruption is pending. If a timer interruption is pending, 
control is passed to the timer interrupt check routine. 


The routine next tests to see if there is an interruption for the Emulator 
prompt WTOR. If there is, control is passed to the prompt reply processor 
routine (IIVPRP). 


If DOS was disabled for external interruptions, or none of the above 
interruptions was pending, the system mask portion of the local execution PSW 
is tested to see if I/O interruptions are enabled. If the mask is enabled 

for I/O interruptions, a test is then made to see if the operator has responded 
to the last WTOR issued by the interpretive SYSLOG routine. If he has 
responded, control is passed to the interpretive SYSLOG routine. If he has 

not responded, this routine tests to see if the interpretive SYSLOG routine 

had issued a WTO to the operator and is waiting for DOS to enable for I/0 
interruptions. If so, control is passed to the interpretive SYSLOG routine. 


A test is then made to see if there are any I/O interruptions to be handled 
for the emulated DOS program. If there are, control is passed to the check 
I/O routine. If there were no asynchronous interruptions pending, control 
is passed to the route routine at entry point TIVRTER2. 


STAE Retry Routine (Flowchart 20C) 


This routine gains control from the OS ABEND processing routines when the STAE 
exit routine determines that a bypass is to be affected. The STAE retry routine 
reissues the OS STAE macro to reactivate the ABEND interception procedure. 

Since any outstanding WTORs are canceled by the OS ABEND routines before passing 
control to the STAE retry routine, the WTORsS are reestablished. Control is 
passed to the program setting the bypass switch to an address stored in STAERTN 
(IIVCON) by the program. Each module that sets the bypass ABEND switch and 

the action taken by the module is as follows: 


Modules Requesting ABEND Tnterception 


Function being performed when Action taken upon regaining 
Module name requesting interception control 
rivcecw Adjusting CCW data addresses Channel program check returned 
ITIVRCW to DOS 


IIVDVS Cancel DOS job; issue message 
IIVv2561 


Opening a file 


Reading the VTOC using an OS 
OBTAIN macro 


Cancel DOS joh; 
TTV261T 


issue message 


Issuing an OS EOV macro to get an 
additional extent 


Cancel DOS job; 
TIV2601 


issue message 


Opening a dedicated device for 
SIO processing 


A ‘device not operational' 
indication is returned to DOS; 
message IIVO18I is issued 


ITIVOPN 
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Timer Interrupt Check Subroutine (Flowchart 20D) 


This subroutine is entered from the select routine (TIVRTESL) to check for 

a DOS timer external interruption. The timer pending switch is set off and 
the DOS timer is tested for a value greater than 0. If the value is greater 
than 0, the time indicator switch is set on. 


The DOS timer is then decreased by 1 second and again tested for a value greater 
than 0. If the value is less than 0 and the time indicator switch is on, the 
time indicator switch is set off, the interruption code in the local execution 
PSW is set to indicate a timer external interruption, the local execution PSW 
is moved to the DOS external old PSW, and the DOS external new PSW is moved 

to the local execution PSW. 


An OS STIMER for 1 second is issued, and control is given to the route routine 
at entry point IIVRTER2. 


Timer Interrupt Subroutine (Flowchart 20D) 


This routine is the STIMER completion exit routine for the STIMER macro issued 
by the Emulator. It gains control from OS when the interval specified by the 
STIMER macro instruction, issued in the timer interrupt check routine, has 
expired. 


The timer interrupt pending switch is set to 1 to indicate that the STIMER 
interval has expired. The DRI switch is turned off, and the timer =©CB is 
posted so that if the Emulator was in the wait state, it receives control from 
OS to indicate expiration of the STIMER interval. 


The timer ECB is one of the ECBs pointed to by the ECB pointer table and thus 
is one of the ECBs waited on by the asynchronous interrupt exit routine when 
it enters the wait state. After the timer ECB is posted, this routine passes 
control back to the OS control program that called it. 


Asynchronous Interrupt Check Subroutine (Flowcharts 20E-20F) 


This routine tests all Emulator ECBs to see if any of them have been posted 
by OS as complete. As each posted ECB is found, this routine sets a switch 
on or increases a counter to indicate to other Emulator routines that an 
asynchronous interruption is pending and must be processed. 


Except for SYSLOG, a 2-byte entry is created in the post ECB list when an ECB 
for an I/O device has been found posted. The first byte contains the offset 
value of the I/O device in COMTAB. The second byte contains the status byte 
of the posted ECB. After all Emulator ECBs have been tested, this routine 
returns control to the calling routine. 


End-of-Job Routine (Flowchart 20G) 


This routine gains control from IIVRTE when DOS tries to load a wait PSW with 
interruptions enabled and the end-of-job Switch (EOJSW) is set to 1. It also 
gains control from the prompt reply processor (IIVPRP) at the time the operator 
command EOJ is received. If it is determined that all DOS processing is 
complete, the Emulator is terminated. 
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The following conditions are checked to determine if all DOS processing is 
complete: 


The number of outstanding I/O operations must be equal to zero. 


The first byte of the background PIB must contain X'82' to indicate that 
the DOS background partition is waiting for an interruption to restart. 


In a multiprogramming system, both foreground PIBs must contain X'80' to 
indicate that they are both active. 


The DOS SYSRDR LUB must be valid. 


The IOB CSW unit exception bit for the background SYSRDR device must be 
1 to indicate end-of-file on the device. 


The background SYSRDR device IOB address is found by mapping the SYSRDR 
LUB index for the DOS PUB associated with it to the COMTAB entry for the 
device. This mapping is done through the OS PUB table. 


If all of these conditions are met, emulation is ended by a return to OS by 
means of the Exit ABEND error routine (IIVABN). 


Prompt Reply Processor Routine (IIVPRP) ~- Flowcharts 21A-21E 


This module receives control from the select routine (ITIVRTESL) 


operator replies to the operator prompt message issued by the Emulator. The 
following Emulator commands are recognized: 


EOJ 


EXT 


ATTN 


The operator wishes to terminate the Emulator region after all DOS 
partitions become inactive. The end-of-job switch (EOJSW) is set 
to notify the end-of-job routine that emulation may be ended when 
all DOS partitions are inactive. 


A DOS external interruption is desired. The interruption code is 
set, and a DOS external interruption is simulated. 


The DOS attention routines are desired. The interruption code is 
set, and a DOS I/O interruption is simulated. 


MAPIO The operator requires the corresponding channel and unit numbers of 


MOUNT The operator wishes to mount a new DASD volume. The operand is tested 


DEBUG 


the DOS and OS T/O units. The operand is tested to determine whether 


the request is for all or selected DOS cuu's, and messages to the 
operator are constructed accordingly. 


for the DOS cuu and new volume serial number. An OS CLOSE macro for 
the DCB that corresponds to the DOS cuu is issued, the new volume 
serial number is inserted in the JFCB, and an OPENJ macro is issued. 


events occur in DOS. See "Emulator Service Aids" for information 
about the modules that perform trace and snap functions. 


All commands and their operands, if any, are verified and appropriate error 
messages are issued if errors are detected. The error message becomes the 


text of the subsequent prompt. 


Seciiecucne: ‘qeueaiinaccieemmen” “‘eteniames:.~ aemmas, _ “acbeieimmcons: 


GC26-3777, for more information about prompts. 


Control is always returned to the select routine (IIVRTESL). 
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when the console 


The operator wishes to snap dump Emulator control blocks when certain 


C 


SVC Monitor Routine (IIVGR2) -- Flowcharts 22A-22D 


This module monitors SVC 1, 2, 4, and 11 calls from DOS, recognizes OS 
sequential DASD and direct-access shared data sets, DOS sequential DASD and 
direct-access shared files, or OS indexed sequential shared data sets, and 
passes control to the volume-sharing simulation routine (IIVDVS) or the ISAM 
mapping routine (IIVIS), as the case mav be. IIVGR2 is entered from module 
IIvsvc when a DOS SVC is trapped and sequential DASD or direct-access shared 
or OS indexed sequential shared data sets are specified by the DD statement. 


If the shared DOS svstem residence option is in effect or a shared DOS PCTL 

is being used, and the SVC number is 1 or 4, the phase name is checked for 

a call from MAINT, SLNKEDT, or CORGZ. If equal, an * is placed in the last 
position of the phase name to cause DOS to issue the ‘phase not found! message 
OS06T. An Emulator message, IIV2C08A, is also issued. This will protect the 
core image library from being accidentallv updated. 


The routine calls TIVYDVS when an OPEN or CLOSE macro or an end-of-extent 
condition is identified for a sequential DASD or direct-access shared data 
set (file). It calls IIVIS when an OPEN, CLOSE, SETL, SETFL, or ENDFL macro 
is identified for an OS indexed sequential shared data set. 


IIVGR2 uses a five-character table to identify the B-transient phase being 
called by DOS, after which the data set must be identified as sequential DASD 
or direct-access shared, OS indexed sequential shared, or DOS dedicated. The 
two phases are: 


Open Phase 


DOS provides a ‘file ID* field in the DLBL/EXTENT image, and a SYS number in 
the DTF or DLBL/EXTENT image. 


By uSing the SYS number and the DOS cuu pointed to by the LUB, the routine 
identifies the corresponding COMTAB entry. This entry indicates either a DOS 
dedicated file, in which case control returns to IIVSVC to let DOS process 
the OPEN macro, or a sequential DASD or direct-access shared or OS indexed 
sequential shared data set (file), in which case the COMTAB extension is 
searched for a match between the DOS program DTF name and the DTF name in the 
FID. 


If a match is not found, the message MISSING DD STATEMENT is issued and control 


is given to DOS, which issues an SVC 6 (cancel). If a match is found, the 
routine sets the code, the COMTAB extension address, the DTF address, and the 
LTK in the parameter list located in EMUCONS before calling IIVDVS or IIvis 
to perform the open. 


Nonopen Phase 


The routine searches a FID for a match between the DTF names. If a match is 
not found, it returns to IIVSvc to let DOS execute the phase. If a match is 
found, it sets the DTF and FID addresses in the parameter list located in 
EMUCONS before calling IIVDVS or IIVIS as before. 


After calling IIVDVS or IIVIS, the routine checks register 15 for an error 
code. If there is one, it issues an SVC 6 and returns to module IIvsve. If 
there is not an error code, it determines from the NXTBTR field in EMUCONS 
which B-transient phase has to be executed. If none is specified, the routine 
returns to module IIVSvc, which gives control to DOS by means of module TIVRTE 
to execute the instruction following the SVC instruction. If a B-transient 
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name is given, the routine moves it in place of the existing one and returns 
to module IIVSVC, which then returns control to DOS to execute the Svc 2 
instruction. 


To sum up, IIVGR2 returns to IIVSvC {and later to DOS) to execute: 


e the Svc 2, 4, or 11 when a sequential DASD or direct-access shared or OS 
indexed seauential shared data set (file) is not being processed 


° or the instruction following the SVC instruction when the supervisor call 
has been simulated by the Emulator 


In case of an error, the routine returns to module IIVSvVC in order to execute 
a DOS Svc 6, which cancels the DOS step. 


Device Sharing Simulation Routine (IIVDVS) -- Flowcharts 23A-23H 


The routines in this module move the extent limits from OS (DEB) to Dos 
(DLBL/EXTENT card image) so that DOS will use the actual extent limits of the 
file as determined from OS JCL. 


In addition, the following control blocks are created or updated to reflect 
the fact that an OS file is being processed: 


e DCB - created and opened when DOS requests that a 
file be opened; closed when DOS requests 
that a file be closed or at the end of a 
DOS jok step (except for DOS svstem files) 


e DT™F - maintained to reflect the status of the file as 
determined by OS 


e Open table - updated to reflect the actual seek addresses in 
the VToOCc and some specific indicators (see 
open table below) 


e COMTAB - maintained for the Fmulator to identify 
extension and sequential DASD and direct-access shared 
FID data sets (files) 

e EMUCONS - maintained as a communication area between 


TIVDVS, IIVGR2, and ITITVPCE 


e Obtain area - created and maintained for IIVVIO to return 
VOL1, identifier and extension DSCBs to DOS 


Processing of a sequential DASD or direct-access shared data set (file) is 
divided into seven routines, all included in TIVDVS (Pigure 18). 


IIVDVS expects the following control blocks and registers to be set by DOS 
open phases: 


e Register 7 points to DOS communication region. 

° Register 2 points to the current DTF. 

e Open table indicators (X'4A3' of B-transient phase) set for special open. 
° Address of DLBL (X'4A8! of B-transient phase). 

The image of the first DLBL/EXTENT™ statement should have been read into 


storage (open/end of extent cnly) at address ¥'378' of B-transient phase 
(for sequential disk) or in label area (direct access). 
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Control Routine 
(Passes Control to 

the Open, Close, or 
End-of-Extent 
Routine) 


End-of-Extent 
Routine 


Close Routine Open Routine 


Obtain Routine 


Build DLBL 
Routine 


Return Routine 


Figure 18. General Flow of IIVDVS 


IIVDVS updates the following control blocks and DOS registers to reflect the 
fact that some DOS open phases have been bypassed: 


DOS register 
° Register 6 is set to point to the DLBL/EXTENT card image. 
Open table 


e Open table indicator (X'4A3' of B-transient phase) is set to show special 
open for SYSLNK. 


e Message indicator (X'6A1' of B-transient phase) is set to show the type 
of DTF being processed. 
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e VTOC in-storage indicator (X'4A0! of B-transient phase) is set to show 
that the vToOC has been read into. 


e vToc lower and upper limit (X'3EO' of B-transient phase) are set with the 
identifier (format 1) DSCB address (sequential disk only). 


e Seek bucket (X'3FC! of B-transient phase) will contain the address of 
identifier (format 1) DSCB in VTOC. 


° Logical unit in VTOC CCB (X'3E8' of B-transient phase) will contain the 
logical unit of the file (input sequential only). 


e Search argument (X'409') will contain the file ID of the file (input 
sequential only). 


DTF 
@ Open communications byte in DTF will reflect current status. 


e Volume sequence number in DTF will contain X'0001' when opening a sequential 
output file. 


e DTF flag 1 (X*15* of DTF) indicators such as DELETFL=NO will be turned 
on for work files. 


° vtToc address (X'020! of DTF) will contain the identifier (format 1) DSCB 
address in VToc for work file. 


e User label address (X'05C! of DTF) will contain the disk address of user 
label extent for DTFDA. 


DLBL 


° User label seek address (X'30' of DTF) will contain the disk address of 
user label when $$BOSDO6 is called. 


e Search argument (X'3C') and LIOCS search argument (X'4C') will contain 
the actual disk address of the first extent when $$BOSDO6 is called. 


e DLBL/EXTENT card image will contain the extent limits, extent type, extent 
sequence number, logical unit, volume serial number, expiration and creation 
dates, and DLBL indicator according to the OS information about the file. 


Control Routine (Flowchart 23A) 


This routine gains control from IIVGR2 and examines a parameter list (PARMLST) 
located in EMUCONS. PARMLST contains the address of the DTF to be processed 
(PARMDTFA), the key of the partition Owning the DTF (PARMLTK), a code indicating 
the operation to be performed (PARMCODE), and (in PARMFDCS) a pointer to the 
associated COMTAB extension for an open function or a pointer to the associated 
FID for an end of extent or close function. 


The routine sets standard linkage conventions (save area and registers), and 
then initializes registers to point to COMTAB extension, FID, DTF, and DLBL. 


According to PARMCODE, the routine exits to the open, end-of-extent, or close 
routines in this module. 
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Open Routine (Flowcharts 23A=-233) 


This routine is entered from the control routine when PARMCODE indicates an 
open function is to be performed. EMUCONS should contain the following DOS 
phase names in the fields indicated: 


NXTBTR after 


Type OLDBTR NXTBTR Open routine 
Sequential output £$BOSD01 $$BOSDO1 $$BOSDO1 
Sequential input $S5BOSD01 SS$BOSDI1 $$ BOSDT1 
Sequential work $$BOSD01 SSBOSDW1 $$BOSDW2 
Direct access f SBOPEN2 $$ BODAIN $$BODAIN 


The routine obtains storage for a new FID by means of module IIVGET, attaches 
this FID to the chain of FIDs pointed to by DSFIDBLK in EMUCONS, and sets in 
it the COMTAB extension pointer (FIDCTXTN), the DTF name (FIDTFNME), and the 
key (FIDLTK). 


If the file is not yet opened (CTDCBUC=0), the routine obtains storage for 
a DCB by calling: IIVGET and initializes the DCB with the following: 


e DSORG=PS 

e MACRF= (E) 

e DEVD=DA 

e Appendages (same as for dedicated volumes) 

° DDname from CTDDNAME 

e Exit list to point to an inactive exit list 

An OS OPEN for output is issued for the data set associated with this DCB, 
and the DCB is checked for a successful open. If an error occurs, message 
CANNOT OPEN is transmitted and the routine branches to the return routine. 

If no error occurs during the open, CTDCBPTR is set in the COMTAB extension, 
the track balance (DCBTRKBAL) is set to 0, and the address of the last record 
(DCBFDAD) is set to point to the last track of the last extent so that OS will 
not try to write an EOF record at close. 

The use count for this file (contained in the CTDCBUC field of the COMTAB 
extension) is increased by one. The device types, as specified in the DOS 
DTF and OS DCB, are checked for identity. If not identical, the message NO 
MATCHING DEVICE TYPE is issued and control is given to the return routine. 


For direct-access files, control is given to the obtain routine. For sequential 
disk files, register 6 is set to point to the DLBL/EXTENT card image. 


Depending upon the type of file as indicated by the name of the DOS phase to 
be fetched, the following control blocks are updated: 


sequential input (DOS calling $$BOSDI1) 
e The volume sequence number in the DTF is set to 1. 
e The LIOCS switches in the DTF are reset for DTFSD. 


e The message code in the open table is set to 3. 
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sequential output (DOS calling S$BOSDO1) 
e The new volume switch is reset in the DTF. 

> 
e The open bit in the DTF is reset for a system file. 


° The volume and extent sequence numbers are set to their values in the 
DLBL/EXTENT card image. 


e The message code in the oren table is set to 4. 
sequential work file (DOS calling $$BOSDW1) 


e Indicators "DELETFL=NOt, *SYSxxx in DTF', and textent open!’ are set in 
the DTF. 


e The message code in the open table is set to 9. 
° The NXTBTR in EMUCONS is set to S$SBOSDW2., 


Control is then given to the obtain routine. 


End-of-FExtent Routine (Flowcharts 23C-23D) 


This routine is entered from the control routine when PARMCODE specifies EOX. 
The end-of-extent routine's main purpose is to give an additional extent to 
DOS for sequential input or output files. 


However, the meaning of "OX has been extended to cover all cases where DOS 

calls the B-transient phases for a file that is already opened, except for 

close conditions, which are processed in the close routine. These cases can 

be divided into four main categories as fcllows: J 


Obtain Only Cases. The DOS B-transient phase to be executed next will access 
the vToc. 


Type OLDBTR NXTBTR 
Anv Any $$30MSG1 
Nirect access in- 
put, user iabel FSBODAT1 $$BODAU1 
Direct access 
user label SSBOFLPT $$BODAUT 
Sequential disk 
outvut, trailer label *830SDC1 $ $BOSDO6 
Sequential disk 
input, trailer label F$BOSDC1 S$S$30SNT3 
Sequential disk 

. input header label $*BOSDI1 S$BOSDI3 
Direct access 
input $SBODAIN S$BODAT1 


The end-of-extent routine will indicate that an obtain is to be performed and 
branch to the okFtain routine. Control eventually returns to DOS, and the 
access to the vVT0Cc will be routed and handled by module TIVVIO., 
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User Labels Cases. The DOS 3-transient phases to be executed next will create 
the user label track. 


NXTBTR NXTBTR 
Type OLD BTR before after _ 
Sequential disk $SBOSDO4 $ $BOSDO6 £$BOSDO6 
output $$BOSDO9Y % $BOSDO6 $$ BOSDO6 


For sequential disk output files with user labels (when running with DOS release 
26), the routine sets the appropriate user label track address and data track 
address in the DTF prior to branching to the obtain routine. When running 

DOS release 27, the correct user label and data track address in the DTF have 
already been set by the obtain routine. 


End-of-Extent Cases. The DOS problem program calls the B-transient phases 
in order to open (or, rather get the next extent for the file. 


NXTBTR NXTBTR 

Type OLDBTR before after 

Sequential disk 

output S$SBOSDC1 $$BOSDO1 $$BOSDO5 

Sequential disk 

output $$BOSD01 f$BOSDO1 $$BOSDO5 

Sequential disk 

input $S$BOSD01 $$BOSDT 1 $$ BOSDI2 

Sequential disk 

work file S$$BOSD01 $ $BOSDW3 *$BOSDW3 

Sequential disk 

work file $$BOSDC1 $ SBOSDW3 *$BOSDW3 
The routine checks whether the required extent is present in the DEB; if it 
is, the routine branches to the obtain routine, which updates the DTF and 
branches to the build DLBL routine to create a DLBL/EXTENT card image reflecting 


the extent. 


If the required extent is not present in the DEB, the routine issues a message 
and eventually the DOS job step is canceled; for an output file only, the 
routine issues an OS EOV to get secondary allocation from OS if any was 
specified in the OS DD statement. 


Other Cases 


NXTBTR NXTBTR 
Type OLDBTR before after 
Work file $$B0SDW2 $$BOSDW1 € $BOSDW2 
S$S$BOFLPT $SBOSDW1 f $ROSDW2 
Direct access 
output $$BODAIN $SBODAO1 XXXXXXXX 


where XXXXXXXX = $SBODAUI or SS$BOFLPT or FSBOPEN. 


$$BOSDW1 is called to get the next DLBL/EXTENT statement, if any. This DOS 
phase will be bypassed by moving $$BOSDW2 in NXTBTR, except when the routine 
reaches the last extent as indicated in the DEB, in which case NXTBTR will 

not be updated and £$BOSDW1 will complete the DOS open processing for the work 
file. For direct access output, NXTBTR is updated as described above and the 
routine branches to the return routine. 
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Other special cases are: 


° Call for B-transient phase for sequential input at EOF ($S$BOSDI1 is called 
by $$BOSDO1). The end-of-extent routine will then let DOS execute $$BOSDI1 
by branching to the return routine. 


e Call for a B-transient phase for sequential output at the end-of-extent 
time (S$BOSDO1 is called by $$BOSD01) whenever the end-of-extent address 
is specified in the DTF. The end-of-extent routine will then let DOS 
execute $$BOSDO1 by branching to the return routine. 


° Call for a B-transient phase for sequential work file when a DOS POINT 
macro is issued ($$BOSDW3 is called by $$BOSD01). The end-of-extent routine 
will first check the validity of the given seek address prior to branching 
to the current work file end-of-extent case and issue a message if the 
seek address does not fit into any extent in the DEB. 


Close Routine (Flowchart 23E) 


This routine is entered from the control routine, and the following DOS program 
names must be set in the indicated fields of EMUCONS: 


Type OLDBTR field NXTBTR field 
Sequential disk &SBCLOSE €$BOSDC 1 
Sequential disk $$BOSDC1 S$SBCLOSE 
Sequential disk $$BOSDC2 $SBCLOSE 
Sequential output 

user label $$BOSDI3 $S5BCLOSE 
Sequential input user 

label $ $BOSDO6 $$BCLOSE 
Sequential disk $$BOSDC1 PRPGM 
Sequential disk $$BOSDC2 PRPGM 
Sequential input user 

label $$BOSDI3 PRPGM 
Sequential output user 

label $$80SD06 PRPGM 
End of job -- $ SBEOJ 
Direct access $$BCLOSE $$BODACL 


When OLDBTR contains $$BCLOSE, this routine branches directly to the obtain 
routine in order to build VOL1 (volume 1), identifier (format 1) and extension 
(format 3) DSCB images, so that the next DOS phases can read from the VTOC 

if needed. 


When NXTBTR contains PRPGM, which indicates that DOS is issuing an SVC 11 
instruction, the routine identifies a time close condition (f$BOSDI3 or $S$BOSDO06 
issuing an SVC 11 may be for header labels at open). When a time close 
condition is recognized, the use count (CTDCBUC) is decreased and tested for 

a 0. If the use count is not 0, control is given to the return routine to 

free the current FID and return to module TIIVGR2, If the use count is 0, the 
routine issues an OS CLOSE for the file, frees the storage used bv the DCB, 
resets the pointer to the DCB in the CTDCBPTR field of EMUCONS, and branches 

to the return routine to free the current FID. 
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Obtain Routine (Flowcharts 23F-23G) 


This routine is entered from the open, end-of-extent, or close routines. It 
initializes a constant area (IIVOBTE1), which is pointed to by ATIVOBE1 in 
EMUCONS, with all of the vVToCc information needed by DOS. The following fields 
in the obtain work area are initialized: 


OBVOL'1 21 characters of a VOL1 label 

OBF1LBL identifier (format 1) DSCB for the data set 

OBF3LBL extension (format 3) DSCB for the data set, if needed 
OB1COUNT format 1 count information 

OB 3COUNT format 3 count information 


OBF1LBL and OBF3LBL are built by means of the OBTAIN macro. The obtain routine 
then updates the following control blocks: 


Direct-Access Files 


The user label address is moved into DTFDA. 


Sequential Work Files 


The vToc address is moved from the obtain area into DTFSD in the form CHHR 
for DOS releases 25 and 26, and CCHR for DOS release 27. 


Sequential Input Files 


In order to simulate the bypassing of the DOS phase $$BOSDI1 for both open 
and end-of-extent cases, the following control blocks are updated: 


e Logical unit (SYS number) in the open table 

e Binary number in the open table and DTF 
Identifier (format 1) DSCB address in the open table seek bucket and limt 
bucket 

e File ID (dsname) in the open table 

e NXTBTR (in EMUCONS) to be S$SBOSDTI2 


Sequential Output Files 


The first three control blocks described for sequential input files are updated 
to simulate the bypass of $$BOSDO1 and $$BOSDO2. In addition: 


e 'vTOC read' indicator in the open table is set on 

e "Special opent indicator in the DTF is reset if not a system file (filename 
must start with IJSYS) 

e NXTBTR in EMUCONS is set to contain S$BOSDO5 at end-of-extent time, $SBOSDO4 
at open time (if not release 27), S$BOSDO9 at open time (for release 27) 


When running DOS release 27 only, the bypass of $$BOSDO4 is simulated by: 


Setting DOS register 0 with the appropriate control factor 

Increasing the volume sequence number in the DTF 

Moving identifier (format 1) DSCB address in the DTF 

Moving the actual user label address in the DTF and setting the ‘header 
user label* indicator in the DTF 


The obtain routine then exits to the build DLBL routine after setting the 'last 
extent' indicator in the DLBL/EXTENT card image if the extent being processed 
is the last one in the DEB. 
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In case of sequential output files, the ‘last extent! indicator is set only 
if the extent is the last one in the DEB and if there is no secondary allocation 


in the DD statement. 
) 


Return Routine (Flowchart 234) 


This routine is entered from the other routines in IIVDVS when the function 
to be performed is completed. If everything is in order, a completion code 
of 0 is set in register 15 before returning to IIVGR2. 


When an error must be indicated to IIVGR2, a value of 1 is set in register 
15 and a message is issued to the operator by means of module TIVMSG. 


Control returns to IIVGR2 after its registers have been restored. 


Build DLBL Routine (Flowchart 23H) 


This routine is entered from the obtain routine. Registers DCBREG, DTFREG, 
DLBLREG, DEBREG, and CTXTNREG must previously have been set. The routine first 
sets the following indicators in the DLBL/EXTENT card image: 


Extent limits converted to DASD address on 
Next extent on a new pack on a new volume off 
New volume on same unit off 
Bypass extent off 
No extent card off 
The volume serial number is then moved from the OS UCB into the DLBL volume 
serial and file serial. If the file is a sequential disk file, the extent .) 


type and extent upper and lower limits are moved into DLBL from the 
corresponding extent in the DES, and the routine exits to the return routine. 


If the file is a direct-access file, the same processing is repeated for every 
extent found in the DEB. When there is not enough space in the DLBL/EXTENT 
card image to contain all the extents described in the DCB, a message 


INSUFFICIENT EXTENT SPACE is transmitted, and control is given to the return 
routine. 


ISAM Mapping Routine (IIVIS) -- Flowcharts 24A-24L 


Main Task Control Executive Routine (Flowchart 24A) 


This routine is the entry point for mapping OPEN, CLOSE, SETFL ENDFL, and SETL 
functions. Control is passed by module IIVGR2 when a B-transient phase is 
required to process an OS indexed sequential data set. The required function 
is mapped from the DOS request to the equivalent OS request. 

When this routine is entered, the following information is supplied: 


e Register 11 contains the address of the EMUCONS area in which a parameter 
list for this module is contained 


e Register 10 contains the address of DOS storage 
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e The 2-word parameter list contains the following: 


- The first byte of the first word is the function code (OPEN, CLOSE, 
SETL, etc.) 


- The last 3 bytes of the first word contain the DTFIS table address 


= The second word contains the address of the COMTAB extension (CTEXT) 
for OPEN, or the file ID block (FIDBLK) address at all other times 


After checking for a valid function code, control is passed to the proper 
mapping routine or an error message is issued and control is returned to DOS. 


Open Mapping Routine (Flowchart 24B) 


This routine is entered each time a DOS OPEN is issued for an OS indexed 
sequential data set. Main storage is obtained in which to build the ISBLK, 


which is added to the chain of ISBLKs. The starting ISBLK address is contained 


in the ISFIDBLK field in EMUCONS. Each ISBLK holds an OS register save area, 
control information area, DCB3(s) area, and a DECB area. A RDJFCB macro 
instruction is issued to obtain JCL information. 


The type of DTFIS that is being opened determines the additional work still 
required. 


LOAD Open Mapping Subroutine (Flowchart 2483) 


For a LOAD DTFIS table (type X'24') where the DLBL open code is C for create, 
the DCB is completed from one of three sources: the DTFIS, the JFCB, or by 
default value. The priority of input varies by field as indicated in Figure 
19: 


Mapped to OS Mapped from DOS Mapped from Default 
DCB field DTFIS field JFCB field value 
DCBBLKSI IJHKBKLN (2) JFCBLKSTI (1) N/A 

DC BLRECL IJHKLGLN (1) N/A NWA 
DCBKEYLE IJHKLGLN+2 (1) N/A N/A 
DCBRECFM IJHKOPCO N/A N/A 
DCBRKP IJHKNRCD+1 2 (1) N/A N/A 
DCBMACR N/A N/A (PM) (1) 
DCBCYLOF Number of tracks JFCCYLOF (1) 3 (3) 


per cylinder 
(IJHKHNDV+4) (2) 


DCBOPTCD IJHKOPCD (2) JFCOPTCD (1) Always R(3) 
reoOrganiza- 
tion criteria 

DCBBUFNO N/A JFCBUFNO (1) 2(2) 

DCBNTM N/A JFCNTM (1) 3 (2) 


Figure 19. Sources of Input to DCB Fields at OS Indexed 
Sequential Data Set Creation 


When these values have been initialized, an OPEN TYPE=J macro instruction is 
issued. If the open fails, the DOS task is terminated upon return of control 
to DOS. If the data set is successfully opened, the IJHKLPDR and- IJHKPRCT 
fields in the DTFIS table are loaded from the DCBLPDA and DCBNRFc fields, 
respectively, of the DCB. 
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For a LOAD DTFIS table (type X'2uUt) where the DLBL open code is E for extension 

load, only the OPEN TYPE=J macro instruction is issued and, if the data set 

is successfully opened, the IJHKLPDR and IJHKPRCT fields of the DTFIS table 

are loaded. o 


When the data set has been successfully opened for a LOAD DTFIS, the code used 
to trap and map T/O macro instructions is moved into the DTFIS takle in the 
CcW build area (TJHKRDWR) and the ISMOD address in the DTFIS is modified to 
point to this code. Control is passed to the subtask attaching routine. 


ADD, RETRVE, ADDRTR Open Mapping Subroutine (Flowchart 24B) 


This subroutine opens an OS indexed sequential data set for ADD, PETRVE, or 
ADDRTR DTFIS tables, types X¥'25', X¥'26', and X'27", respectively. When the 
data set has been successfully opened, an OS work area is obtained to support 
the add function of ADD or ADDRTR type DTFIS tables. 


The DTFIS table fields significant to the Emulator are completed from the 
information contained in the OS ISAM DCB (see Figure 20). 


Mapped to DOCS Mapped from OS 
DTFIS field DCB field 
IJHCRESZ DCELRECL 
IJHCKYSZ CCBKEYLE 
IJHCBLSZ DCBBLKSI 
TIHCKYLC DCBRKP 
IJHACPRC CCBNREC 
TIHACOTC DCBRORG3 

IJ HAC OFC DCBRORG1 
ISHACORC DC BNOREC ’ 
IJHCCLPA DCBLPLA 


Figure 20. Source of Input to Supported DTFIS Fields at Open of 
ADD, RETRVE, and ADDRTR 


Control is passed to the subtask attaching routine. 


Subtask Attaching Routine (Flowchart 24B) 


This routine's primary function is to attach an OS suktask to perform the DOS 
ISAM macro mapping. A subtask is used so that other DOS tasks can continue 
to run when it is neceSsary to await the completion of the I/O required to 
access the OS indexed sequential data set. 


The entry point for the subtask is at TIVISO1 within the IIVIS CSECT. This 
entry point is established by issuing an IDENTIFY macro instruction upon the 
first entry into the open mapping routine and setting a swtich in the first 
byte of AIIVIS in EMVCONS to indicate this macro has been issued. Also upon 
first entry, a CHAP macro instruction is issued to reduce the dispatching 
priority of the Emulator task by an order of 1 so that the subtask(s) can run 
at a higher priority when attached. 


After the IDENTIFY and CHAP macro instructions have been issued, the address 
of the ISBLK is ovlaced in register 1 and all 16 of the OS registers are stored 
in the register save area of the ISBLK. An ATTACH macro instruction is then 
issued to create the subtask. 
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The open mapping routine has completed its function at this point and control 
is returned to the calling routine. 


Close Mapping Routine (Flowchart 24C) 


This routine is entered each time a DOS CLOSE macro is issued to an OS indexed 
sequential data set. Any work area obtained to support the add function of 
ADD or ADDRTR DTFIS tables is released. The subtask that was attached to 
handle the DOS ISAM macro instructions to the OS indexed sequential data set 
is removed by issuance of an OS DETACH macro instruction. The data set is 
closed by issuing a CLOSE macro instruction. The ISBLK is unchained from the 
string of other ISBLKS and the area is released. Control is returned to the 
calling routine. 


SETL Mapping Routine (Flowchart 24D) 


This subroutine Maps a DOS SETL macro instruction to an OS SETL macro 
instruction. The DTFIS must be for either RETRVE or ADDRTR, and IOAREAS must 
be nonzero to allow execution. If execution is not possible, the DOS task 

is abnormally terminated with an Svc 50 instruction. 


If an OS SETL macro instruction is outstanding, an OS ESETL macro instruction 
must be issued to clear the SETL status in the DCB. ' If the DCB is not open 
to support the type of OS SETL macro, the DCB is closed, the DCBMACR field 

is respecified, and the DCB is reopened. Then the OS SETL macro instruction 
corresponding to the DOS SETL is issued. The mapping is performed as follows 
in Figure 21: 


DOS SETL OS SETL 
Type BOF Type B 
Type KEY Type K 
Type GKEY Type KC 
Type ID Type I 


Figure 21. Mapping of DOS SETL to OS SETL 


Control is passed to the status mapping routine so that any error conditions 
can be returned to the DOS problem program by means of the DTFIS status byte. 


SETFL and ENDFL Mapping Routine. No function in OS corresponds to the DOS 
functions of SETFL and ENDFL, so any attempt to map them results in a NOP and 
control returns to the DOS problem program. 


Subtask Control Executive Routine (Flowchart 24E) 


This routine is entered when the open mapping routine issues the ATTACH macro 
instruction. The OS supervisor registers are saved and the routine's registers 
are loaded from the ISBLK register save area (pointed to by register 1). The 
subtask control executive routine then issues a WAIT macro instruction and 
enters the wait state until called upon to dispatch an ISAM macro instruction 
mapping request. 
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“hen the ECB in the ISBLK is posted by the SIO routine in module IIVPCE, the 

subtask control executive routine gets control, determines the validitv of 

the request, and passes control to the proper mapping routines. After mapping 

is complete, the subtask control executive routine is reentered and again goes ) 
into the wait state until the next request. 


Get Mapping Routine (Flowchart 24F) 


This routine maps the DOS ISAM GET macro instruction to the OS ISAM GET macro 
instruction. Prior to issuing the GET, a check is made to ensure that a SET™L 
was oreviously issued. If a SET™L had not previously been issued, the DCB is 
checked to ensure it is open for QISAM; if not, the DOS task is terminated 

by an Svc 50. Tf the DCB is open for QISAM, the GET macro is issued and the 
OS ISAM module issues a SETL for the beginning of file. 


When a SETL has been issued, the OS GET is issued. A successful completion 
allows this routine to move the logical record from the OS buffer into the 

DOS area reserved for it (specified by the IOAREAS parameter of the DTFIS 
macro). The key for unblocked files is also moved. The DOS address of the 
logical record is stored in the DTFIS table and the record is moved into the 
WORKS area, if the WORKS area is specified. The DASD address of the block 

is obtained from the DCB work table and stored in the DTFIS table for reference 
by the problem program. If the record is to be processed in IOAREAS, then 

code is created so that the address is loaded when the DOS task is reentered, 


Final status is mapped to the DTFIS table by the status mapping routine. 


Put. Mapping Poutine (Flowchart 24G) 


This routine maps the DOS ISAM PUT macro to the OS ISAM PUTX macro. If a GET 2 
macro has not been issued to this data set by the problem program pricr to 

the PUT, the DOS problem program is abnormally terminated by means of an SVC 

50 instruction. 


When the record is processed in the WORKS area, it is first moved to the TOARFAS 
logical record location. The logical record is moved from IOAREAS into the 
OS buffer logical record location, and an OS PUTXK macro is issued. 


Upon return from the PUTX, the status information is mapped from the DCB to 
the DTFIS takle by the status mapping routine. 


ESETL Mapping Routine (Flowchart 24G) 


This routine Maps the DOS ISAM ESETL macro to the OS ESETL macro. If a SETL 
macro has not been issued for the data set prior to the ESETL, the routine 
returns to the suktask control executive routine. Otherwise, an OS ESETL is 
issued. Control is passed to the status mapping routine. 
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Read Key Mapping Routine (Flowchart 248) 


This routine maps the DOS READ KEY macro to the OS READ macro, type KU. The 
DTFIS must be built for random retrieval before mapping is possible. If the 
IOAREAR address is zero, the problem program is abnormally terminated with 
an Svc 50 instruction. 


A check is made to determine that a DCB is open for BISAM macro processing. 


The key argument is obtained from the DTFIS table and used in an OS READ type 
KU macro instruction. Upon return from OS, final status is mapped from the 
DECB to the DTFIS table by the status mapping routine. 


Write Key Mapping Routine (Flowchart 24H) 


This routine maps the DOS WRITE KEY macro to the OS WRITE macro, type K. The 
DTFIS must provide for random retrieval and a DOS READ KEY must have been 
issued to the file before mapping is possible. If these conditions are not 
met, the DOS problem program is abnormally terminated by an SVC 50 instruction. 


Any error on the previous READ KEY will not allow the WRITE KEY to be performed, 
so control is returned to the DOS problem program. When all restrictions have 
been met, the updated record is moved from the WORKR area (when specified) 

into the IOAREAR logical record location. The record is then moved from IOARFAR 
in DOS to the OS buffer. An OS WRITE type K macro instruction is issued to 
write the logical record back into the file. 


Final status is mapped to the DTFIS table by passing control to the status 
mapping routine. 


Write NEWKEY Mapping Routine (Flowchart 24J) 


ThiS routine maps the DOS WRITE NEWKEY macro to the OS WRITE type KN macro. 

The DTFIS table must provide for random adding of logical records before mapping 
can be accomplished. If this condition is not met, the DOS problem program 

is abnormally terminated by an SVC 50 instruction. 


The key argument is moved to the save area in the DTFIS table, its address 
is stored in the DECB, and an OS WRITE type KN macro instruction is issued. 


Final status is mapped to the DTFIS table by the status mapping routine. 


WAITF Mapping Routine (Flowchart 24k) 


This routine simulates the DOS WAITF Macro instruction for DOS WRITE NEWKEY, 
READ KEY, and WRITE KEY processing. If one of these macro instructions has 
not been issued, the problem program is abnormally terminated by an Svc 59 
instruction. 


For either WRITE macro instruction, a CHECK macro instruction is issued to 


determine if the I/O operation has finished. This routine exits to the status 
mapping routine. 
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When the I/O is a READ KEY, an OS CHECK macro instruction is issued and the 
DASD address and logical record are moved to the DOS problem program storage 
locations. The logical record is moved into the WORKR area, if specified. 
If IOREG is specified, code is created in the DTFIS CCW build area to load 
the register with the address when the DOS problem program regains control. 
This routine exits to the status mapping routine. 


ISAM Mapping Subroutines 


svc 50 Subroutine (Flowchart 24L) 


This subroutine cauSeS an SVC 50 instruction to be the next instruction issued 
when the DOS task acquires control after the I/O operation has been completed. 
This is done so that the DOS task will be canceled for violating a DOS 
restriction. The user must check his program logic to determine the cause. 


OPENFAIL Subroutine (Flowchart 241) 


This subroutine causes the DOS OPEN message writer to be the next B-transient 
phase called because of errors that have occurred during the process of opening 
an OS indexed sequential data set. This causes the DOS task to terminate. 


SYNAD Subroutine (Flowchart 241) 


This subroutine is entered from the OS ISAM logic modules when €rror conditions 
have been detected while performing OS ISAM macro instruction requests. 


The DCBMACRF field is interrogated so that the proper status mapping routine 
can be called. 


Status Mapping Subroutine (Flowchart 24L) 


This subroutine is the common exit point for all subtask I/O mapping routines 
and the SETL mapping routine. Its function is to map the statistics fields 
and last prime data record address from the DCB to the DTFIS. This subroutine 
also maps completion status from either the DECB or the DCB exceptional 
condition bytes, fields DECBEXC1-DECBEXC2 and DCBEXCD1-DCBEXCD2, respectively, 
to the DTFIS exception condition status byte, field IJHCSTBY (see Figure 22). 


Entry is at one of three entry points, depending on whether the OS ISAM DCB 

is used for QISAM load, OISAM scan, or BISAM mode. Each entry point contains 
instructions to set up registers to point to the proper OS exceptional condition 
bytes and the corresponding OS-to-DOS mapping table. The mapping table consists 
of a DOS bit, which is set on in byte IJHCSTBY in the DTFIS table, if the 
corresponding bit is on in one of the OS exception bytes. 


Each OS exceptional condition byte is checked independently for a value of 

0. If both are 0, IJHCSTBY in the DTFIS table is set to 0 and the status 
mapping subroutine exit is entered. If a byte is found to be nonzero, the 
proper point in the map table is set and the byte is scanned from left to right 
a bit at a time until all 8 bits have been checked. When a bit is found to 

be 1, the corresponding bit configuration byte in the mapping table is ORed 
into the DTFIS status byte (IJHCSTBY). 
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When both bytes have been interrogated, the status mapping subroutine exit 


is entered. 


This section of the subroutine determines whether the Emulator 


task or a subtask is in control by interrogating a control byte, TAFLAG3, in 


the ISBLK. 


When TAFLAG3 is 0, the Emulator task is in control and a branch 


is made to the main task control executive routine. 


When a subtask is in control, the completion of the OS ISAM I/O request must 


be signaled to the Emulator task. 


This is accomplished by loading the address 


of the COMTAB entry for the request from the ISBLK, creating a CSW in the IOB 
in the COMTAB entry, and issuing a POST macro instruction for the ECB in the 


COMTAB entry. 


Control is then passed to the subtask control executive routine 


which will zero TAFLAG3 in ISBLK and enter the wait state. 


Mapped to DOS 
DTFIS field 


Mapped from OS 
DcB field + 


IJHACRRC DCBNREC Prime data record count 
IJHACOTC DCBRORG3 Number of independent over- 
flow records 
IJ HACOFC DCBRORG1 Number of cylinder overflow 
area full 
IJHACORC DCBNOREC Overflow record count 
IJHCCLPA DCBLPDA Address of last prime 
data record 
IJHCSTBY QISAM (Load mode) 
DCBEXCD1 
X*208 x20! 
X'80t Xtour 
DCBEXCD2 
X"'02° X' 80° 
X'our K'4or 
X*80t X'20!# 
X'4ort xt ost 
QISAM (Scan mode) 
DCBEXCD1 
xXx*10° x'80! 
x'ost x' aor 
Xx*'10' x'10° 
x'sor x'ost 
x'8o' X'oge 
Xx'10°# X'02° 
X'10° x'ott 
DCBEXCD2 
x'80! xX*20° 
X'ott X"'108 
BISAM 
DECBEXC1 
X'10° x'8ot 
X'4or x'age 
X'0O2' x*20! 
x*' 808 *K'10! 
X'80° x'oss 
X'10! X'Our 
x'ott X02" 
xX' our X'ott 


Figure 22. Mapping of DCB Fields to DTFIS Fields After Processing of 
Each I/O Macro 
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VTOC I/O Simulation Routine (IIVVIO) -- Flowcharts 25A-25E 


The vroc I/O simulation routines are used to provide vToc label information 
and actual user label extent information to DOS when a data set (file) ona 
shared volume is being opened. 


When the SIO subroutine (IIVPCE) detects a request for I/O on a shared volume 
and the seek address cannot be matched with the extents in the DEB for that 
volume, the request is assumed to be for the accessing of VTOC labels or user 
labels for the data set (file) by a DOS open routine. Control is passed to 
IIVVIO to verify the assumption and provide the requested I/0. 


Routines VIOA through VIOJ are used to determine the type of access requested. 
Routines VIOIO through VIOIOF provide the I/O simulation. 


VIOA - Analyze CCW Command Code Routine (Flowchart 25A) 


The CCW command code is matched with a table containing the acceptable commands, 
and the appropriate processing routine is executed. If no match is found, 
control is passed to VIOERRX. 


Each entry in the command code table is a fullword, containing the command 
code in the high order byte and the address of the routine to be executed in 
the 3 low order bytes. 


Command Code Routine 
03 NOP VIOB 
07 Seek VIOC 
08 TIC VIOD 
31 Search ID equal VIOE 
29 Search key equal VIOF 
12 Read count VIOG 
06 Read data VIOH 
OE Read key/data VIOI 
05 Write data VIOJ 
OD Write key/data VIOJ 


Note: The multitrack bit is ignored. 
The type byte is set by routines VIOB through VIOJ to indicate the type of 
access requested. 


Flag Values Request 

80 Search ID equal for VOL1 label 

40 Search ID equal for (format 1) label 
20 Search ID equal for (format 3) label 
10 Read count 

08 Search key equal 

04 NOP 

02 Read data 

01 Read key/data 

FF Write 
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VIOB - NOP Command Code Routine (Flowchart 25B) 


The NOP flag is set on in the type byte. Control is passed to VIONXT. 


VIOC - Seek Command Code Routine (Flowchart 25B) 


If the user label extent is present in the obtain work area and the seek address 


is for the user label CCHH, the user label flag is set on in the COMTAB 
(CTFLAG3) and the extent is moved to the COMTAB for use by the end-of-extent 
appendage. The return code is set to 00 to notify the calling routine an EXCP 
is to be issued, and return is made to the calling routine. 


If the seek address is for CCHH 0000 or for the CCHH of the VTOC, control is 
passed to VIONXT. 


Otherwise, the return code is set to 08 to notify the calling routine that 
an error condition has been detected and return is made to the calling routine. 


VIOD - TIC Command Code Routine (Flowchart 25B) 


It is assumed that the TIC is one that follows a search. Control is passed 
to VIONXT. 


VIOE - Search ID Equal Command Code Routine (Flowchart 25B) 


If the ID is for the VOL1 label (CCHHR = 00003), the VOL1 flag is set on in 
the type byte. If the ID is equal to the format 1 label ID, the format 1 flag 
is set on in the type byte. If the ID is equal to the format 3 label ID, the 
format 3 flag is set on in the type byte. Control is always passed to VIONXT. 


VIOF - Search Key Equal Command Code Routine (Flowchart 25B) 


The search key equal flag is set on in the type byte. Control is passed to 
VIONXT. 


VIOG - Read Count Command Code Routine (Flowchart 25C) 


The read count flag is set on in the type byte, and the count address is saved. 
Control is passed to VIONXT. 


VIOH - Read Data Command Code Routine (Flowchart 25C) 


The read data flag is set on in the type byte, and the data address is saved. 
Control is passed to VIONXT. 


Method of Operation 


97 


VIOI - Read Key/Data Command Code Routine (Flowchart 25C) 


The read key/data flag is set on in the type byte, and the data address is 
saved. Control is passed to VIONXT. 


VIOJ - Write Data and Write Key/Data Command Codes Routine (Flowchart 25C) 


The type byte is set to X'FF' to indicate no data is to be transferred. DOS 
will be writing the VTOC label so only simulation of the I/O interruption is 
required. Control is passed to VIONXT. 


VIONXT - Get Next CCW Routine (Flowchart 25C) 


Tf the current CCW command code is a TIC and if the command chain bit is on 

in the cCcW, the CCW pointer is increased to point to the next CCW in the chain. 
Control is then passed to VIOA. Otherwise, control is passed to VIOIO to 
select the correct simulation routine. 


The following routines determine the type of I/O requested and provide any 
data required by the DOS open routine request. The type byte flags are tested 
for the combinations set by the command code routines VIOB through VIOJ. The 
data transferred to the DOS data areas is the real vToc label data built by 
the obtain subroutine within module IIVDVS. The obtain work area containing 
the vToc labels is in module IIVDVS starting at label IIVOBTE1. The address 
of IIVOBTE1 is in EMUCONS at label ATIVOBE1. 


The type byte must indicate one of the following CCW chains or the I/O request 
is considered invalid. 


VIOWKD - Write a VTOC label 

(1) Seek (CCHH equal obtained format 1 CCHH) 
(2) Search ID equal 

(3) TIC to search (2) 

(4) Write key/data 

(5) Search ID equal 

(6) TIC to search (5) 

(7) Read key/data skip on 


VIORDV1 - Read VOL1 label 

(1) Seek (CCFH 0000) 

(2) Search ID equal (CCHHR 00003) 
(3) TIC to search (2) 

(4) Read kev/data 


VIORDV12 - Read VOL1 label data only 
(1) Seek (CCHH 0000) 

(2) Search ID equal (CCFHR 00003) 

(3) TIC to search (2) 

(4) Read data 


VIORDF3 - Read format 3 label 

(1) Seek (CCHH equal obtained format 1 or 3 CCFH) 

(2) Search ID equal (CCFHR equal obtained format 3 CCHHR) 
(3) TIC to search (2) 

(4) Read key/data 
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VIORDF1K - Read format 1 label data only 

(1) Seek (CCFH equal obtained format 1 CCHH) 

(2) Search ID equal (CCHHR equal obtained format 
(3) TIC to search (2) 

(4) Search key equal multi-track 

(5) TIC to search (4) 

(6) Read data 


VIORDF1C < Read format 1 label count and data 

(1) Seek (CCHH equal obtained format 1 CCHH) 

(2) Search ID equal (CCHHR equal obtained format 
(3) TIC to search (2) 

(4) Read count multi-track 

(5) Search key equal 

.(6) TIC to read count (4) 

(7) Read data 


VIORDF1D - Read format 1 label key and data 

(1) Seek (CCFH equal obtained format 1 CCHH) 

(2) Search ID equal (CCHHR equal obtained format 
(3) TIC to search (2) 

(4) Read key/data 


VIORDFO - Read format 0 count field 

(1) Seek (CCHH equal obtained format 1 CCHH) 

(2) Search ID equal (CCHHR equal obtained format 
(3) TIC to search (2) 

(4) Read count multi-track 

(5) Search key equal 

(6) TIC to read count (4) 

(7) NOP 


VIOIO - vroc I/O Simulation Selection (Flowchart 


The type byte is matched with a table containing 
the appropriate processing routine is executed. 


1 CCHHR) 


1 CCHHR) 


1 CCHHR) 


1 CCHHR) 


25c) 


the combined type codes, and 
If no match is found, control 


is passed to VIOERRX. Each entry in the type code table is a fullword 
containing the combined type code in the high order byte and the address of 
the routine to be executed in the 3 low order bytes. 


Combined Type Code Routine 
FF Write VIOIOA 
81 Read VOL1 key/data VIOTOB 
82 Read VOL1 data VIOIOB1 
21 Read F3 key/data vioiIoc 
4A Read F1 data VIOTOD 
5A Read F1 count/data VIOIOD 
41 Read F1 key/data VIOIOE 
1C Read FO count VIOIOF 
5C Read FO count VIOIOF 


VIOIOA - Write Simulation Routine (Flowchart 25D) 


Control is passed to VIOIOSIM. 
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VIOIOB - Read VOL1 Label Simulation Routine (Flowchart 25D), 
VIOIOB!1 


The VOL1 label is moved from the obtain work area to the address specified . 
in the read CCW. Control is then passed to VIOIOSIM. 


VIOIOC - Read Format 3 Label Simulation Routine (Flowchart 25D) 


The F3 label in the obtain work area is moved to the address specified in the 
read CCW. Control is then passed to VIOTCSIM. 


VIOIOD - Read Format 1 Label (Data) Simulation Routine (Flowchart 25D) 


The data area of the F1 label in the obtain work area is moved to the address 
specified in the read CCW. Control is then passed to VIOICSIM. 


VIOTOE - Read Format 1 Label (Key/Data) Simulation Routine (Flowchart 25EF) 


The F1 label in the oktain work area is moved to the address specified in the 
read CCW. Control is then passed to VIOTOSIM, 


VIOIOF - Read Format 0 Count Field Simulation Routine (Flowchart 255) ) 


The count field of the F1 label in the obtain work area is moved to the address 
specified in the read count CCW. Control is then passed to VIOIOSIM. 


VIOERRX - Error Exit Routine (Flowchart 25E) 


The return code 08 is set in register 15, and return is made to the calling 
routine. 


VIOIOSIM - Simulation Exit Routine (Flowchart 25E) 


The return code 04 is set in register 15, and return is made to the calling 
routine. 
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Exit ABEND Error Routine (IIVABN) -- Flowcharts 26A-26B 


This routine is entered when simulation of some error condition to DOS or 
termination of the Emulator is required. 


The routine examines the error code passed from the module in which the error 
was found. The proper message is printed if the calling routine has not already 
printed it. The error codes are: 


04 - Return to OS (any queued devices are dequeued by means of 
the DEQ macro) 

08 - DOS hard wait 

12 - Invalid or no IPL device defined 

16 - Invalid CCW found by IIVvccw 

20 - Emulator CCW chain table size exceeded 

24 - No seek or no bin number for IBM 2321 Data Cell Drive 


If a DOS partition is being canceled, the channel end and program check bits 

in the DOS CSW are turned on to force DOS to cancel the partition. Partition 
cancelation occurs for errors found by the IIVCCW routine, for example, invalid 
CCW data address or CCW not ona doubleword boundary (error code 16), if the 
Emulator CCW chain table size is exceeded (error code 20), or if the IIVPCE 
SIO routine finds invalid 2321 CCWs (error code 24). Exit is made to the 
caller for return to DOS if the Emulator region is to be canceled. cCCWs for 
active devices are adjusted to local addresses, and an OS snap dump of DOS 
registers 0 through 15 and DOS storage is taken if the JCL statement //SYSSNAP 
DD SYSOUT=A was included for the Emulator job step. A service aid printout 
instead of the snap dump will be taken if the DEBUG option is specified. The 
routine returns to OS. The Emulator is canceled if the DOS supervisor attempts 
to enter a hard wait (error code 08), if there is insufficient main-storage 
Space to run the Emulator (error code 04), or if an invalid or no IPL device 

is defined (error code 12). 


Message Writer Routine (IIVMSG) -- Flowchart 27A 


This routine prints all messages issued by the Emulator. See Figure 8&8 entitled 
"Message-to-Module Relationship" for specific message codes, message numbers, 
and module names. Emulator routines can request a message to be printed by 
issuing an Emulator macro called EMUMSG. This macro generates the code required 
to pass control to this routine. The parameters passed to IIVMSG are used 

to select the message text to be printed, complete the message with any 
supplemental text provided by the caller, and determine if the request is for 

a WTO or WTOR. 


Emulator messages are contained within three text modules: IIVMG1, IIVMG2, 
and IIVMG3. These modules contain messages appropriate for issuance by the 
Emulator during initialization (IIVMG1), after initialization (IIVMG2), and 
when volume and data set sharing has been requested (IIVMG3). 


Each message is identified with a unique message code. Within each text module, 
messages are assigned sequential numbers from 1 to 99. These numbers are added 
to the appropriate module identifier to form the message code used in the 
EMUMSG macro call. The module identifier for IIVMG1 is 0, for TIIVMG2 is 100, 
and for IIVMG3 is 200. The module identifier determines both the message and 
the required module. 
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Two Emulator macros, MGTXT and MSGCOD™, are used to create the message text 
modules. 
modules. 
the constants for the text itself. MSGCODT is issued once in each module, 
and it must be issued after all the MG™XT calls. MSGCOD™ generates a message 
index table. 


MGTXT is issued for every message contained in each of the text 
The macro generates control bytes used for supplemental text and 


The three macros, EMUMSG, MGTXT, and MSGCCD™, are described below. 


EMUMSS 
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MSGCODE= {code} 
{ (reg) } 


{data address} 
[ ,FILL={D(data address) } ] 


{ (reg) } 


{reply address} 
f,REPLY={D(reply address) } 
{ (reg) } 


fecb address} 
,ECB={D(ecb address) } 


{ (reg) } 


,REPLEN= {reply Length} } 
{ (reg) } 


where MSGCODE is a required parameter: 


FILL 


code is the message code described above (IIVMG1, 1-99; ITVMG2, 101- 
199; IIVMG3, 201-299). 


(req) is one of registers 0 through 12, which contains the message 
code in the low-order hyte. 

is an optional parameter: 

data address is the symbolic address of the supplemental text. 


D(data address) is the same as data address except the symbolic address 
is ina DSECT. 


(reg) is one of registers 1 through 12, which contains the text 
address. 


REPLY (see note helow): 


ECB 


reply address is the address of the reply area. 


D(reply address) is the same as reply address, except the address 
is a DSECT label. 


(reg) is one of register 1 through 12, which contains the reply 
address. 
(see note below): 

ecb address is the address of the ECB. 

D(ech address) is the DSECT address of the ECB. 


(reg) is one of registers 1 through 12, which contains the ECB address. 
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REPLEN (see note below): 
reply length is the length of the required reply. 


(reg) is one of registers 1 through 12, which contains the reply 
length in its low-order byte. 


Note: The parameters REPLY, ECB, and REPLEN must all be present or all 
omitted. Any parameter not enclosed by brackets must be oresent. 


MGTXT {'text"} 
f(...,'text',...,N,e--)} 


where ttext' is the message text in quotes; use this form when no 
supplemental text is required. (...,'text',...,n,..-) is used 
when supplemental text is required. The information within the 
parentheses represents any combination of 'text' and n, separated 
by commas. The n represents a field length for the supplemental 
data. The placement of the n relative to the ‘text! determines 
the displacement of the field to be filled. 


For example, MGTXT (‘THIS IS AN‘t, 8) generated code would be: 


DC AL2 (8) Length of supplemental data 

De ALI (128) Last entry indicator 

DC AL1 (11) Byte position within the message text 
De CfTHIS IS AN * 

DC CL8 ¢ 


Assuming the above macro call is the fifth issuance of MGTXT in module 
TIVMG2, then the message code is module identifier (100) + 5 = 105. 


To print this message, the requesting routine issues the macro EMUMSG: 
EMUMSG MSGCODE=105, FILL=CATA 
where DATA [PC CL8*EXAMPLE. ! 
The resulting message will be: 
THIS IS AN EXAMPLE. 
Actually the message text must contain the message identifier (TIVxxxT) 
and space for an 8-byte job name, which the message writer always fills 


in. All MGTXT macro calls must, therefore, begin as follows: 


MGTXT 'IIVxxxTtT jobname ...' 
(jokname=space for 8-byte Emulator ‘job name) 


or ('ITVxxxT jobname ...',..e.) 


where xxx = message ID and T = message type. 
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MSGCODT No required parameters. 


This macro is issued once in each message text module. It must he 
issued after all the MGTXT calls. Global values in the MGTXT macro 
are used to generate a table containing the following information: 


DC A(maximum message number) 
or 
DC A(number of MGTXT calls) 
DC AL1 (length of message 1) 
DC AL3 (address of message 1 including any control 
bytes for supplemental text) 


Repeat for message 2, and so on. 


Service Aids Initialization Routine (IIVRAS) -- Flowcharts 28A-28B 


The major function of module IIVRAS is to control the program flow of the 
service aids modules TIVRCP and IIVSNP. 


At entry to this routine, the DCB for SYSSNAP is opened and address constants 
in CSECTs IIVRCN and IIVCON are initialized. If register 0 contains zero at 
the time of entry, the service aids command processor IIVRCP is loaded into 
main storage. Control is then passed to IIVRCP to process a debug statement. 
Module IIVRCP is deleted after control is returned. Module IIVSNP is then 
loaded, and its main-storage address is placed in CSECT IIVRCN. Control is 
then returned to the caller. 


If register 0 contained a value of 4 at entry time, the Emulator snap dump 
routine IIVSNP is loaded into main storage. Control is then passed to module 
ITVSNP to snap the Emulator wraparound trace table. This will normally happen 
at Emulator end-of-job time. Control is returned to the caller after the trace 
table is snapped. 


If register 0 contained a value greater than 4, register 1 must contain a main- 
storage address of a two-byte length field. This field contains the length 
minus one of a character string that describes the cause of the snap dump 
(OPTION IN EFFECT gives the cause of the snap dump). The character string 
immediately follows the length field. Control is passed to module IIVSNP to 
Snap Emulator control blocks. After the Emulator storage is snapped, control 
is returned to the caller. 


The following routines in IIVRAS gain control depending on the type of 
interruption that occurs: 


IIVRASPC - Program Check Intercept Initialization Routine (Flowchart 28B) 


Control is gained at this entry point after the occurrence of a program check 

interruption when the CPU is in local execution mode. DOS registers are saved 
and Emulator registers are restored. This subroutine exits to module IIVPCI, 

which further interrogates the program check interruption. 
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IIVRASVC - Supervisor Call Intercept Initialization Routine (Flowchart 28B) 


Control is gained at this entry point after the occurrence of a Supervisor 
call interruption when the CPU is in local execution mode. DOS registers are 
saved and Emulator registers are restored. This subroutine exits to module 
IIVSCI, which will further interrogate the supervisor call interruption. 


IIVRASYN - Asynchronous Intercept Initialization Routine (Flowchart 288) 


Control is gained at this entry point after the occurrence of an asynchronous 
interruption when the CPU is in local execution mode. DOS registers are saved 
and Emulator registers are restored. Jf requested, control is passed to a 
user asynchronous exit routine. Control will then be passed to module IIVSNP 
if an optional snap dump is indicated. DOS registers are then restored and 


‘ this routine exits to the Emulator module TIIVRTE. 


Command Processor Routine (IIVRCP) -- Flowcharts 29A-29P 


This routine gains control from IIVRAS in order to read a DEBUG statement from 
card input or a DEBUG console reply to the Emulator prompt. 


Each command of the DEBUG statement is checked for syntax validity. Each 
keyword or parameter is then analyzed and corresponding indicators are set 

in RASCONS to be used by the service aids modules. These modules (IIVACI, 
TIVPCI, IIVSCI) are loaded by IIVRCP with user exit modules (if any) when an 
END command is encountered. Control then returns to IIVRAS, which will delete 
IIVRCP and resume emulation. 


Snap Dump and Trace Formatting Routine (IIVSNP) -~- Flowcharts 30A-30K 


The major function of module IIVSNP is to format the Emulator control blocks 
and trace table. A nonzero value in register 0 at entry to this routine will 
cause only the trace table to be printed. The main line code consists of calls 
to subroutines that convert main storage data to EBCDIC and write the formatted 
data. 


Trace Table Subroutine (Flowchart 30E) 


The entry point label of the trace table subroutine is RAS14000. Control is 
returned to the caller if the number of active trace table entries is zero. 
Otherwise, each entry is converted from its internal format (see Figure 84, 
Internal Trace Table Format) to its printed format (see Figure 86 (Part 6 of 
7). Service Aids Snap Dump). Trace table entries are printed starting with 
the most recent entry. Each succeeding line represents an older entry. The 
trace table pointers are reset immediately after snapping so no two snaps will 
reflect the same events. 
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Write Subroutine (Flowchart 30H) 


The entry point label of the write subroutine is RAS15000. When this subroutine ) 
is entered, register 1 contains the address of a two-byte length field, which ) | 
contains the length in bytes minus one of a character string; the character 

string immediately follows the length field. Each line is blocked until the 

buffer is filled, at which time the entire buffer is written out. A secondary 

entry point (RAS15200) will cause the buffer to be truncated and written. 

Control is returned to the caller. 


Snap Subroutine (Flowchart 308) 


The entry point label of the snap subroutine is RAS16000. 
Register contents upon entry to this subroutine are: 


° Register 0 - the length in bytes of main storage to be snapped 
e- Register 1 - the starting address of the main storage to be snapped 


Control is first passed to the EBCDIC conversion subroutine (entry point is 
RAS17000) to convert hexadecimal data to EBCDIC. The EBCDIC data is then 
formatted in fullword secticns for readability bv the data formatting subroutine 
(entry point is RAS18000). Control is then passed to the write subroutine 
(entry point is PAS15000). Data is snapped 32 bytes at a time until the length 
(passed in register 0) is reached. Only the first line of a set of duplicate 
lines is printed so that the volume of output is minimized. 


EBCDIC Conversion Subroutine (Flowchart 30G) ) 


The entry point label of the EBCDIC conversion subroutine is RAS17000. 
The register contents upon entry to this subroutine are: 


@ Register 0 - the number of bytes to convert 
e Register 1 - the main-storage address of the hexadecimal data to be 
converted 


The number of bytes contained in register 0 is rounded to the next fullword. 

A maximum of 72 bytes can be converted at any one time. Output data is vlaced 
in a work area labeled BUFF1. After conversion, control is returned to the 
caller. 


Data Formatting Subroutine (Flowchart 30J) 

The entry point label of the data formatting subroutine is RAS18000. 

The register contents upon entry to this subroutine are: 

, Register 0 - the number of bytes to format 

° Register 1 - the beginning of main-storage address to contain the formatted 


output 


Input data is found in a work area labeled B3UFF1. EBCDIC data is formatted 
in fullword segments for readability. Control is returned to the caller. 
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Program Check Intercept Routine (IIVPCI) -- Flowcharts 31A-31C 


The major function of module IIVPCI is to intercept DOS program check 
interruptions. IIVPCI receives control from module IIVRAS (entry point is 
IIVRASPC) after DOS registers have been saved and Emulator registers have been 
restored. Control will be passed to module IIVSNP to snap Emulator control 
blocks if a snap for DOS program checks was requested and if a nonprivileged 
operation program check or if a nonEmulator supported privileged operation 
exception is encountered. Snap dumps during DOS IPL are bypassed unless 
specifically requested because of the number of program checks that occur 
during that time. 


The first of two snaps of the Emulator control blocks and main storage will 

be taken for user selected privileged operations that are issued by DOS. This 
dump will be a picture of the Emulator region before instruction simulation 
by the Emulator. The second snap will be issued by module IIVACI. This dump 
will contain a picture of the Emulator region after the instruction is 
simulated. 


User selected privileged operations will be entered into the Emulator trace 
table if a trace table was requested. Since all required trace information 

is not available at program check time, a flag is set in TIVRCN (RASCONS) to 
indicate that that entry must be completed by module TIVACI. Just before 
passing control to Emulator module IIVPCE, control will be passed to a program 
check user exit routine if one was specified. An optional snap dump will be 
taken if the exit routine returns to the address in register 14 plus a 
displacement of four. 


Supervisor Call Intercept Routine (TIVSCI) -- Flowchart 32A 


Module IIVSCI receives control from module IIVRAS (entry point is IIVRASVC) 
after the occurrence of a supervisor call interruption while the CPU is in 
local execution mode. 


Tf an SVC snap dump was requested, a four byte field at hexadecimal location 
1A8 in CSECT TIVRCN will contain the starting main-sStorage address of a chain 
of SVC control blocks. Each entry in the chain is 12 bytes in length and has 
the following format: 


SVC Points to next entr 
0 1 4 


Control is passed to module IIVSNP to snap Emulator control blocks if the 
interruption field in the local execution PSW matches the SVC number in byte 
0 of an entry. A value of zero in the next entry field (byte.1) indicates 
the last entry in the chain. In the case of SVC numbers 2 and 4, the main- 
storage address contained in DOS register 1 is adjusted and compared with the 


8 character module name in byte 4 of the entry if that field contains a nonzero 


value. An equal compare will cause a snap dump to be taken. 
If svc or ALL were specified for trace, the trace table will be updated. 


The supervisor call interruption will then be partially recorded in the trace 
table if Svc or AIL are specified for TRACE. Just before exiting to module 
IIVSVC, control will be passed to a supervisor call user exit routine if one 
was specified. An optional snap dump will be taken if the user exit routine 
returns to the address contained in register 14 plus a displacement of four. 
This routine restores DOS registers and exits to the Emulator module IIVSVC 
to process the SVC instruction. 
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Asynchronous Intercept Routine (IIVACI) -- Flowcharts 33A-33H 


Module IIVACT receives control from the various Emulator modules when control 

is to be returned to DOS. The address constant ART20 (which ordinarily contains 
the main-storage address of IIVRTER2) is replaced Ey module TIIVRCP with the 
entry point address of IIVACI. 


Since this routine gains control from other Emulator modules, it is assumed 
that registers are set up with standard Emulator values. If the current trace 
entry is flaaged incomplete, it is completed according to the type of 
interruption it represents. The trace table pointers are then updated. 
Asynchronous interruptions (I/0, EXT, TIMER) are then checked and entered if 
requested. 


Control is passed to module ITVSNP to issue the second of two snap dumps if 
indicated by module IIVPCI. This snap dump will reflect Emulator main storage 
after a valid DOS privileged operation was simulated by the Emlator. 


The PSW and COMP snap functions are also handled in module IIVACI. If these 
options are specified, a snap dump will be taken whenever the conditions are 
satisfied. Asynchronous interruptions (I/O, EXT, TIMER) are checked and a 
Snap dump is taken if requested. The local execution user exit routine is 
given control just before passing control to module IIVRTE at entry point 
ITIVRTER2. An optional snap dump is taken if control is returned to the address 
in register 14 plus a displacement of four. 


Service Aids Adjust CCW Data Address Routine (IIVRCW) -- Flowcharts 34A-34H 


The main function of IIVRCW is the same as TIVCCW. The DOS local addresses 
in the data address portion of the CCWs will be adjusted to OS true addresses 
or realijusted from OS true addresses to DOS local addresses. 


The first path of TIVRCW is similar to TIVCCW. BEFLK entries are created 
according to the channel program to be processed. The BEBLK entries contain 
pointers to the begirning and ending addresses of each consecutive set of CCWs 
found in the channel program. 


The second step of ITVPCW is slightlv different from TIVCCW in that the CCWs 
will not be adjusted or readjusted in the DOS area, but will leave the bos 
channel programs unchanged. 


Start I/O Time 


IIVRCW copies the DOS channel program into a buffer located in the DIAG block 
(the block is created by ITVRCP when the DIAG command routine is entered). 
The data address portions of the CCWs in the buffer are then adjusted to OS 
true addresses and the TIC addresses will point to the corresponding CCW in 
the buffer. The IOB is then modified to reflect that the OS EXCP should be 
issued on the channel pregram located in the DIAG block. 
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I/O Completion Time 


IIVRCW is called by IIVCHK when the OS EXCP is complete. The data address 
portions of the CCWs in the buffer are readjusted to DOS local addresses. 

The TIC addresses will point to the corresponding CCW in the DOS area. When 
readjustment is complete, the channel program located in the DIAG block should 
be identical to the channel program located in the DOS area. A check is made 
on each CCW and message IIvV281I is issued if the CCWs do not match. The IOB 

is then modified to reflect that the I/O is completed on the DOS channel program 
(the CSW will be pointing to the corresponding CCW in the DOS area). 
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Flowcharts 
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FUNCTIONAL ORGANIZATION OF EMULATOR INTERRUPTION HANDLING 


In Figure 23, the major Emulator interruption handling functions are grouped ) 
relative to the modules that perform them. 


FLOWCHARTS 


This section contains flowcharts of Emulator routines. In general, the 
flowcharts have the following characteristics: 


The 


Symbols, or labels, are used where possible to aid readers in locating 
instruction sequences in listings. 


Where CPU control passes from one routine or subroutine to another, terminal 
blocks are always used. Off page connectors are used only when a single 
routine or subroutine extends over two or more pages. 


Information necessary to understand a module and its interaciton with the 
rest of the Emulator is given in text preceding each major module. 


Redundancy is sometimes used to avoid excessive cross-referencing; the 

same function may sometimes be shown in two or more flowcharts, even though, 
in each case, it is performed with the same set of instructions. 

Each flowchart identifier begins with a numerical value ranging from one 

to two digits. The numerical prefix is unique for each module. The 
flowchart identifiers end with an alphabetic character ranging from A-Z, 
omitting the letters I and O to avoid confusion with the digits 1 and 0. 

The alphabetic character following the numerical prefix of the flowchart 
identifier, starts with the letter A and progresses alphabetically for 

each flowchart of a module. 
flowcharts are divided into seven categories: 

Initialization 

Synchronous interruptions 

Asynchronous interruptions 

Direct-acces volume sharing 

Abnormal end conditions 


Message writer 


Emulator service aids 


Figure 24 shows the module relationships of the Emulator. 
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Program 
check in DOS 


Program Check Interrupt Handler (IIVPCE) 


Other 


Program $lO 


Checks 
EXCP 
is ee ed 


After 
Staged Add/delete 1/O interrupt asynchronous 
in DOS 


Asynchronous Interrupt Handler and Route Routine (IIVRTE) 


Prompt Return 
Reply SYSLOG oe aes (cos* to DOS 
Processor oeel on 


SVC Interrupt 
in DOS 


Service 
Aids 


SVC Interrupt Handler (IIVSVC) 


SVC 2 Volume 
ISAM Processor 


1. Depending on the DEBUG options taken, service aids may first receive control. 
2. Service aids can also be activated during initialization if a //SYSDEBUG DD statement is present. 


Figure 23. Functional Organization of Emulator Interruption Handling 
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Emulator 


HiWVLOG 
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Interruption 
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IIVCHK 


Asynchronous Interruption 


IIVADD 
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IVRTE 
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Machine 


External 
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Note: Module 11VRAS functions are not included in this diagram (see ‘Emulator Service Aids" for information concerning the 
relationship of 1IVRAS to other Emulator modules). 


Figure 24. Emulator Module Relationship 
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DOS Emulator Entry Routine (Flowchart 1A) 


Module name: IIVENT 

Entry point name: IIVENT 

Major functions: 

e Saves registers 

e Saves pointer to user parameter area 

® Establishes a CSECT of constants (EMUCONS) at assembly time 
Entered from: OS 


Modules called: IIVINT 


Exits to: 
e ITIVIN2 
e TIVABN 


OS macros issued: SAVE 

Input: Register 1 points to the pointer to the user parameter area 
Output: Register 7 points to the user parameter area 

Return codes: xX'04*' on exit to IIVABN 

Tables/work areas: None 

Errors detected: None 


Messages requested: None 
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Flowchart 1A. 
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EMULATOR 
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DOS Emulator Entry Routine (IIVENT) 


(CHART 26A) 


Initialization First-Load Poutine (Flowcharts 24-2M) 


Module name: IIVINT 

Entry point name: ITIIVINT 

Major functions: 

Verifies parameters 
Establishes DOS storage area 


Initializes CCMTAB 
Tnitializes COMTAB extension 


Entered by: IIVENT 


Modules called: 


2 IIVGET 
e TIVMSG 
Exits to: 


® Caller 
e TIVABN 


OS macros issued: 


WAIT 
EXTRACT 
SAVE 
RDJFCB 
RETURN 


Input: Register 7 points to the user parameter area 
Output: 


® Register 9 points to local execution list 
e Register 10 points to DOS storage area 
e Register 11 points to IIVCON 


Return codes: None 
Tables/work areas: 


TIOT 

COMTAB 

UCB 

JFCR 

Local execution list 

Adjust CCW data address list 
EMUCONS 

COMTAB extension 


Errors detected: 


Invalid Emulator parameters 

No DOSRES DI statement 

Invalid device assigned to Emulator 

Invalid Emulator DDname 

DISP=SHR specified in SYSEMLBL DD statement 


file 


OS cuu from SYSEMLBL not the same as OS cuu from DOS system residence 
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Messages requested: 


IIVO02D 
IITV003D 
IITVOO4D 
IITV005D 
TIv006D 
IITve07D 
TIv008D 
IIVO0O11T 
IIV019TI 
IIVO221I 
TIVO25I 
TIvo261 
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Flowchart 2A. Initialization First~Load Routine (IIVINT Part 1 of 12) 
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Flowchart 2B. Initialization First-Load Routine (IIVINT Part 2 of 12) 
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Flowchart 2C. 


Initialization First-Load Routine (IIVINT Part 3 of 12) 
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PARAMETER 
VALID 


ASKOPR 2L/AI 


GET NEW 
PARAMETER FROM 
OPERATOR 


m 
ASKOPR 2L/AlI 


GET NEW 
PARAMETER FROM 
OPERATOR 


ASKCPR 2L/AlI 


GET NEW 
PARAMETER FROM 
OPERATOR 


SAVE APROMPT 
INDICATOR 


Y 
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Flowchart 2D. Initialization First-Load Routine (TIVINT Part 4 of 12) 


Y 


FROM 2C/K4 


CALCULATE DOS 
STORAGE +4K 
BYTES 


LIVGET TA/A3 


OBTAIN DOS 
STORAGE 


ALIGN DOS 
STORAGE ON 4K 
BOUNDARY 


LIVGET 7A/A3 


RELEASE EXCESS 
STORAGE 
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Flowchart 2E. 


Initialization First~Load Routine (IIVINT Part 5 of 12) 


iy FROM 2D/E3 


CN N 0 


DDSCAN 2M/A1 


GET TIOT ENTRY 


ADD {| TO COMTAB 
COUNT 


ADD {| TO COMTAB 
EXTENSION COUNT 


SET NEXT 
ENTRY INDICATOR 


YES 


G3 


11VMSG 2TA/At 


SYSEM DD NO 
FOR DOSR ISSUES MESSAGE 
SPECIF IE! 11v0221 
YES 
CALCULATE RETURN 


STORAGE NEEDED 
FOR COMTAB 


ERROR CONDITION 


TIVGET TA/A3 


OBTAIN STORAGE 
FOR COMTAB 


yy 
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Flowchart 2F. Initialization First-Load Routine (IIVINT Part 6 of 12) 


FROM 2E/J3 


FROM 2G/H5, 
2G/F1, 2G/H4, GET COMTAB 
2G/G5, 2H/Jl, ADDRESS READ JFCB 
2H/E2, 2H/F3, 
2H/D4, 2H/E5, 
2H/G5: 2H/E3, 
2G/F5, 2H/J3, 
2H/H1, 2H/G4, 
2H/B2, 2H/F5, 
C4 cs 
UPDATE TO NEXT FORMAT DOSLOG SET STAGED YES NO TEMPORARY YES 
COMTAB ENTRY COMTAB ENTRY FLAG IN COMTAB DEVICE STAGED DSNAME 
FROM 
2G/H2 


SET FIRST 
NTRY INDICATOR 


SET SYSIN 
FLAG IN COMTAB 


INDEXED 
SEQUENT LAL 
DATA SET 


SET NEXT NO 
ENTRY INDICATOR 


DDSCAN 2M/Al1 


GET TIOT ENTRY 


SET SYSOUT 
FLAG IN COMTAB 


SET ISAM FLAG 
IN COMTAB 


Fe 


I1VGET TA/A3 


FREE EXCESS 
COMTAB SPACE 


YES LAST TIOT SET SHARED 
ENTRY VOLUME FLAG 


NO 
G2 G3 
I TVMSG 27A/A1 ADD 1 TO 
NO NO COMT AB 
VALID DOS CUU ISSUES MESSAGE XTENSION COUNT, 
Tivoigl 
YES YES 


PLACE DSNAME 
AND _DDNAME_ IN 
TEMPORARY 
COMT AB 

EXTENSION 


PLACE DOS CUU 
IN COMTAB RETURN 


ERROR RETURN 
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Flowchart 2G. 


FROM 2F/H3 


Bt 


[S 1T 
DOSRES VOLUME 


SET DOSRES 
FLAG IN COMTAB 


SET ENQUE 
EXCLUSIVE FLAG 
IN COMTAB 


IS_IT A 
SHARED VOLUME 


SET ENQUE 
SHARED FLAG 
COMTAB 


IN 


INITCT20 Fi 


YES 


NO 


GET UCB ADDRESS 


FROM TIOT 


HI 
YES CLEAR COMTAB 
ENTRY 
NO 
Jt 
YES SAVE OS BIN 
NUMBER_ IN 


COMTAB 


TRANSLATE OS 


DEVICE TYPE TO 
DOS DEVICE TYPE 


SAVE OS CUU IN 
COMT 


AB 


INI TCT30 D3 


NO 


YES 


SAVE DOS DEVICE 
IN COMTAB 


TYPE 


GET UCB 
BEGINNING 
ADDRESS 


SET 2321 FLAG 
IN COMTAB 


Initialization First-Load Routine (IIVINT Part 7 of 12) 


INI TCT35 D4 
LIVMSG 2TA/AI 
NO 
ISSUES MESSAGE 
[LIVOttI 
YES 
SET TP DEVICE RETURN 


FLAG IN COMTAB 


ERROR RETURN 


SET 2703 
DEVICE TYPE 
COMTAB 


IN 


SET 2702 
DEVICE TYPE 
COMTAB 


SET 2701 
DEVICE TYPE 
COMTAB 


IN 


J4 


IIVMSG 2TA/AI 


ISSUES MESSAGE 
TI1VOI9] 


WAS DOS BIN 
NUMBER IN DD 
NAME 


NO 


SAVE DOS BIN 
NUMBER_IN 
COMTAB 


RETURN 


ERROR RETURN 
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Flowchart 2H. Initialization First-Load Routine (IIVINT Part 8 of 12) 


y 


FROM 2G/E3 


SET DASD_ FLAG 
DASD DEVICE IN COMTAB 


INITCTSI 


RESET 
ARE DEVICE DECREMENT 
SHARE _INDDI- COMTAB 
CATORS ON COMTAB EXTENSION COUNT 


INITCT5A INITCT5S2 INITCT54 D INI TCT60 


3 
PUNCH ONLY 
1403 PRINTER DEVICE 


SET TAPE_FLAG SET OCR FLAG SET 2520P 
IN COMTAB IN COMTAB erage IN 


T_ TRACK SET 1403U SET 1442P 
TAPE UNIT DEVICE TYPE IN DEVICE TYPE IN 
COMTAB COMTAB 


SET 7 TRACK SET 3525P 
FLAG IN COMTAB DEVICE TYPE IN 
COMTAB 


INI TCTS5D 


3400 TAPE 
UNIT 


Je 
3420 TAPE 3410 TAPE SET 3410 
UNIT UNIT DEVICE TYPE IN 
COMTAB 
YES NO 


= LIVMSG 27A/Al1 : oe 


ISSUES MESSAGE RETURN 
Iivorel 


ERROR RETURN 
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Flowchart 23. Initialization First-Load Routine (IIVINT Part 9 of 12) 


Ses) FROM 2F/F 1 (e+ ) 


COMPUTE SIZE OF 
COMT AB 


READ JFCB 
EXTENSION 


C4 


}IVGET TA/A3 


GET _COMTAB 
EXTENSION 
STORAGE 


NO DDNAME = 


*SYSEMLBL’ 


IiVMSG 2TA/AI 


ISSUES MESSAGE 
[ivo25l 


GET ADDRESS OF 
COMTAB 


EXTENSION 


[1VMSG 27A/At 


ISSUES MESSAGE 
I1¥0261 
RETURN 


ERROR RETURN 


1S UCB SAME 


SET FIRST 
ENTRY INDICATOR AS FOR DOSRES 


DDSCAN 2M/AI 


GET TIOT ENTRY 


SET LABEL 


SET NEXT 
ENTRY INDICATOR 
EXTENSION 


G4 


[NDEXED 
SEQUENTIAL 
DATA SET 


YES SET ISAM 


RETURN YES 
+4 INDICATORS 


LAST TIOT 
ENTRY 


NORMAL. 
RETURN 


PLACE DATA SET 
NAME IN COMTAB 
EXTENSION 


YES 


PLACE poNane IN UPDATE TO _NEXT 


GET UCB 
B BEGINNING 
EXTENSION EXTENSION ENTRY 


ADDRESS 


GET UCB ADDRESS 


K4 


SAVE DEVICE 
ADDRESS _IN 
COMTAB 
EXTENSION 


YES 


SAVE BIN NUMBER 
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Flowchart 2K. SCAN and YESORNO Subroutines 


SCAN FOR COMMA 
OR BLANK 


RESET SCAN 
TABLE 


RETURN 
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FROM LIVINT (CHART 2A) 


(IIVINT Part 10 of 12) 


YESORNO 


ENTRY 


FROM II¥INT (CHART 2C) 


B4 


PARAMETER YES 
MISSING 


NO 


D4 


PARAMETER 
= NO 


NO 


RETURN 
+12 


IN¥ALID PARAMETER 


PARAMETER YES RETURN 
= YES +4 
D 


Flowchart 2L. ASKOPR and CHKCUU Subroutines (IIVINT Part 11 of 12) 


ASKOPR A CHK Ad 
ENTRY ENTRY 


FROM IIVINT FROM IIVINT 
(CHARTS 2B AND 2C} . {CHARTS 2B, 2F) 


: B4 
IIVMSG 27A/A1 ‘ 
YES 
ISSUE WTOR RETURN+4 
NO 
C4 
NO 
WAIT FOR REPLY <> RETURN+4 
YES 
D4 
6 
NO 
RETURN+4 
TO I11VABN (CHART 26A) 
YES 


SAVE NEW 
PARAMETERS 


TRANSLATE CUU 


TO HEXADECIMAL 


RETURN 


RETURN 
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Flowchart 2M. DDSCAN Subroutine (IIVINT Part 12 of 12) 


DDSCAN20 A3 


DONAME = 
SYSSNAP 


SET SNAP 
PRESENT FLAG 


DO AN A 
eS 


FROM IIVINT 
(CHARTS 2E, 2F, 
2J) 


Bi 


DDSCAN22 


DDNAME = 
SYSDEBUG 


SET DEBUG 
PRESENT BIT 


DDSCAN24 


GET TIOT DDNAME = SET SWITCH FOR 
ADDRESS SYSABEND ABEND DD 
PRESENT 


(01) » 
Dt DOSCAN25 D3 


DDSCANI10 


YES NON SYS YES 
DDNAME RETURN + 8 


UPDATE TO NEXT 


; TIOT ENTRY 
CONCATENATED 
NO 
Gi 
YES 
RETURN 
NO 


Hi 


DDONAME= YES 


*SYSEMLBL RETURN +8 
NO 
KI 
DDNAME = YES 
*SYSEM* RETURN + 4 RETURN +4 


NO 
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Initialization Second-Load Routine (flowcharts 3A-3F) 


Module name: TIIVIN2 


Entry point name: IIVIN2 


Major functions: 


Performs COMTAB and COMTAB extension chaining 


Sorts COMTAB table 

Builds other Emulator tables 

IPLs DOS from the DOS resident volume 
Saves store CPU ID results (STIDP) 


Entered by: IIVENT 


Modules called: 


IIVOPN 
IIVGET 
TIVMSG 
ITIVRAS 
TIVRTE 


Exits to: 


TIVRTE 
Returns to caller cn error conditions 


OS macros issued: 


EXCP 
ENQ 
WAIT 
LOAD 
DEO 
SAVE 
RETURN 
DCBD 
OPEN 


Input: 


Register 9 points to local execution 
Register 10 points to DOS storage 
Register 11 points to TIVCON 


Output: None 


Return codes: None 


Tables/work areas: 


COMTAB 

COMTAB extension 
ISK/SSK table 

ECB pointer table 
Post ECB list 

Local execution list 
EMUCONS 

DOS storage 


list 


Program Organization 


133 


Errors detected: 


Duplicate DOS device address 

Could not IPL DOS for DOS emulation 

Could not open DOS SYSRES DCB 

I/O error on DOS SYSRES 

Missing DD statement for DOS SYSRES volume 
DDname does not map to a DOS device 
Invalid device sharing request 

Invalid starting address for DOS SYSRES 
DOSRES label cylinder in use 


Messages requested: 


IIVO0O12I 
IIVO131 
TIVO 151 
IIV0201I 
IIVO221 
IIVO27I 
IIVO 281 
IIVO331I 
TIVO34T 
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C 


Flowchart 3A. 


FROM _ | IVENT 
(CHART 1A) 


B3 


ANY 
TEMPORARY 
COMTAB 
EXTENSION 


GET ADDRESS OF 
FIRST COMTAB 
AND PRESENT 
CTEXT 


SHARED 
DEVICE FLAG 
ON 


MOVE _ TEMPORARY 
CTEXT FROM 
COMTAB TO CTEXT 


GET NEXT 
EXTENSION 


GET NEXT COMTAB 
ENTRY 


LAST COMTAB 
ENTRY 


Initialization Second-Load Routine (IIVIN2 Part 1 of 6) 
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Flowchart 3B. 


GET CTEXT 
ADDRESS 


1S 


CTEXT YES 
ENTRY CHAINEO 


CLEAR CTEXT 
MAPS FLAG 


GET ADDRESS OF 
COMTAB 


CURRENT 
CTEXT OS 
CUU=CQMT AB 
CUU 


NO 


YES 


Gi 


1S COMTAB 
FLAGGED 
SHARED 


YES 


[1VMSG 2TA/AI 


ISSUES MESSAGE 
L1V034) 


RETURN 


UPDATE_TO NEXT 
CTEX 


EXT 


THIS UNCHAINED 
COMTAB EXTENSION 
ENTRY IS NOW 
REFERRED TO AS 
THE CURRENT 
COMTAB EXTENSION 
ENTRY 


UPDATE TO NEXT 
COMTAB ENTRY 


E2 


LAST COMTAB 
ENTRY 


YES 


NO 


CHNC 


SET CTEXT 
MAPS FLAGS 


PLACE ADDRESS 
OF CURRENT 
CTEXT INTO 

COMTAB ENTRY 
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CH ¢0) 


YES 


Initialization Second-Load Routine (IIVIN2 


A3 


1S CTEXT 
MAPS FLAG ON 


NO 


YES 


‘oe 
7 


3B 
B3f FROM 
3A/B3 


GET NEW CTEXT 
ENTRY 


C3 


NO 


D3 


1S CURRENT 
CTEXT OS CUU=NEW 
OS CUU 


YES 


CHAIN COMTAB 


PLACE ADDRESS EXTENSION 
OF NEW CTEXT TABLE ENTRIES 
INTO CURRENT TOGETHER 


NEW CTEXT 


BECOMES CURRENT 
CTEXT 


CHAIN COMTAB 
--|EXTENSION TO 
COMTAB ENTRY 


Part 2 of 6) 


* 


|}I¥VMSG 27TA/A1 


ISSUES MESSAGE 
11V0331 


RETURN 


Flowchart 3c. 


(c+ ) YES 


RETURN 


ENTRIES 


FROM 
3B/B2 


GET ADDRESS OF 


COMTAB 


COMTAB 
ENTRY =ENTRY+ I 


ENTRY +1 
(LOW) 


SWAP _COMTAB 
ENTRIES 


SET _ENTRY 
SWAP FLAG 


Initialization Second-Load Routine (IIVIN2 Part 3 of 6) 


c5 


LAST COMTAB 
ENTRY 


UPDATE TO NEXT 
COMTAB ENTRY 


YES 


D5 


ENTRY SWAP 
FLAG ON 


NO 


GET CHANNEL 
INDEX ADDRESS 


PLACE COMTAB 
NUMBER IN 
CHIN INDX 


GET COMTAB 
ADDRESS 


INI TLALIZE 
CHANNEL COUNT 
TO ZERO 


UPDATE CHANNEL 
COUNTER 


GET NEXT COMTAB 
ENTRY 


INITIALIZE 
COMTAB ENTRY 
COUNTER 


J4 J5 


NO |LOW COMTAB FOR 
CHANNEL 


COUNTER 


YES EQUAL (<+) 


H1GH 
END OF COMTAB 
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Flowchart 3D. Initialization Second-Load Routine (IIVIN2 Part 4 of 6) 


FROM 
3C/J4 


ENQ MASTER UPDATE TO NEXT 


GET ADDRESS OF 
TAB 


RESOURCE COMTAB ENTRY COM 


C2 


YES DEQ MASTER 
RESOURCE 


PLACE ECB 
ADDRESS_IN ECB 
POINTER TABLE 


CALCULATE SIZE 


GET ADDRESS OF LAST COMTAB 
COMTAB ENTRY OF POST ECB 


LIST 


NO 


DI BLDISK 
D 


JIVGET 7A/A3 


YES 
GET STORAGE FOR 
POST ECB LIST 


NO DEDICATED 
DASD DEVICE 


OR DOSRES 


CALCULATE SIZE LAST COMTAB 
ENTRY 


OF ISK/SSK 
TABLE 


IIVGET TA/A3 


GET STORAGE FOR 
ISK/SSK TABLE 


ENQ DEVICE 
RESOURCE MAY BE 
SHARED 


UPDATE TO NEXT 
COMTAB ENTRY 


FORMAT POST ECB 
LIST 


CALCULATE S1ZE 


ENQ DEVICE 
RESOURCE 
EXCLUSIVE 


INITIALIZE POST 
OF ECB POINTER ECB LIST 
TABLE 


POINTERS 


ENQDVC20 Gl 


IIYGET 7A/A3 


GET STORAGE FOR 
ECB_POINTER 
TABLE 


COMTAB FOR 
DOSRES 


COMTAB 
OFFSET 


COMT AB 


COMTAB_FOR 
DOSIPL OFFSET 


COMTAB FOR 
DOSLOG 


COMTAB 
OFFSET 
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Flowchart 3E. Initialization Second-Load Routine (IIVIN2 Part 5 of 6) 


FROM 3D/F5 


yo LEELWMSG_27A/AI_| 
ISSUES MESSAGE 
I1vo22I 


IPLDOS Bl 


1S THERE A 
COMTAB FOR 
DOSRES 


YES 


COMPUTE ADDRESS 
DOSRES 


OF 
COMTAB ENTRY 


ERROR RETURN 


D1 D3 
D4 


D 
11VOPN 5A/A2 IIVMSG 27A/A1 


D 
yo FRREVOPN SA/AZ_ " 
OPEN DOSRES OPEN GOOD ISSUES MESSAGE RETURN 
TIVOISI 
ERROR RETURN 


YES YES 


DOSRES A 
SHARED VOLUME 


GET FIRST 
COMTAB 


EXTENSION 


DONAME = 
"SYSEM' 


LAST COMTAB 
EXTENSION 


GET NEXT COMTAB 
EXTENSION 


1I1VGET TA/A3 


GET STORAGE FOR 
A DASO OCB 


ENQUE 
OSCUU/RLBL 
EXCLUSIVE 


YES 


OPEN IT 


NO 


TIVMSG 2TA/AI 


ISSUES MESSAGE 
11Vo281 


ja 


1IVMSG 27A/A1 


ISSUES MESSAGE 
}ivoeTl 


]}IVMSG 2TA/AI 


ISSUES MESSAGE 
11vo151 


DEB LOW 
LIMIT VALID 
FOR DOSRES 


RETURN 


ERROR RETURN 
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Flowchart 3F. Initialization Second~Load Routine (IIVIN2 Part 6 of 6) 


FROM 3E/D3 
3E/H3, 36/62 


BUILD CHANNEL 


PROGRAM 


ISSUE _EXCP 
AND WAIT TO GET 
DOS PSW 


C2 
NO 
EXCP GOOD 


ADJUST DOS CCW 
ADDRESSES 


ISSUE EXCP 
AND WAIT TO GET 
$$A$1PL2 


D3 
SAVE RESULTS NO 
*STORE CPU ID’ EXCP GOOD 
INSTRUCT ION 
YES 


PLACE DOS PSW 
IN LOCAL 
EXECUTION LIST 


SET PROGRAM 
CHECK CONDITION 


SET MODEL 135 
CPU SWITCH ON 


FIND DOS CLEAR 
STORAGE ROUTINE IN DOS CLEAR 


STORAGE ROUTINE 


G3 G4 
CLEAR 
CHANGE CHANNEL STORAGE YES STAGED YES LOAD IIVSTG AND 
PROGRAM ROUTINE FOUND SUPPORT 11 VSDT 
REQUESTED 


NO 


ISSUE EXCP 
AND WAIT TO GET II VRTE 20C/H4 
DOS CCW Seue STAE MACRO IF 


ABEND PRESENT 


ISSUES MESSAGE 
II1VOt3sl 


| 
/ 


J4 


IIVRAS 28A/A1 
DEBUG YES 
EXCP GOOD SUPPORT READ DEBUG 
REQUESTED PARAMETERS 
ERROR ROUTINE 


RETUF.N 


YES 


IIVMSG 27A/A1 : Z 


ISSUES MESSAGE RETURN EXIT 
I1vo2ol 
ERROR RETURN NORMAL END TO 
Nae (CHART 
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IPL Add Routine (Flowcharts 4A-4D) 


Module name: IIVADD 


Entry point name: IIVADD 


Major functions: Performs automatic add, delete, 


Entered by: IIVSVC 
Modules called: IIVMSG 
Exits to: IIvsvc 


OS macros issued: 


e TIME 
e SAVE 
Input: 


e Register 1 points to the DOS CCW 


° Register 9 points to the local execution list 


e Register 10 points to DOS storage 


e Register 11 points to IIVCON 


set date and time 


Output: An add, delete, or set date and time statement is placed 


in the DOS input area. 
Return codes: None 
Tables/work areas: 
e DOS PUB 


ad COMTA3 
e EMUCONS 


Errors detected: Invalid automatic add reqeust 


Messages requested: ITV032T 
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Flowchart 4A. IPL Add Routine (IIVADD Part 1 of 4) 
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DOS Emulator Logic 


I 1VADD 


ENTRY 


FROM -LIV¥SVC (CHART 17A} 


B3 


NO FIRST TIME 
IN ADD 


ROUTINE 


SAVE DOS CCB 
ADDRESS 


GET ADDRESS OF 
DOS PUB TABLE 


GET LENGTH OF 
DOS PUB TABLE 


SET PUB-X 


GET ADDRESS OF 
COMTAB 


SET 
COMTAB-X TO 


SET _ADD 
ROUT INE 
FIRST-TIME 
SWITCH 


SET DOS DATA 
AREA TO BLANKS 


PUB-X 1S THE 
ADDRESS OF 
THE PRESENT 
PUB ENTRY 


BEING 
PROCESSED 


COMTAB-X_1S 
THE ADDRESS OF 
THE PRESENT 
COMTAB ENTRY 


BEING 
PROCESSED 


4B 
B3 


Flowchart 4B. 


IPL Add Routine (IIVADD Part 2 of 4) 


SET DEL 


COMPLE 


ET 
T 


IONS 
E 


YES 


YES 


4B 
B3 
FROM 4A/K3 


B3 


DELETIONS ES 
COMPLETED 


yy 


GET ADDRESS OF 
COMTAB 


DECREMENT PUB-X 
BY | ENTRY 


E3 


END OF DOS 
PUB TABLE 


NO 


F3 


{1S THIS A 
NULL PUB 


NO 


COMTAB CUU 
= TO PUB-X 
CUU 


WHEN PUB-X HAS 
EEN 


B 
DECREMENTED TO 
THE DOS PUB 
TABLE BEGINNING 
ADDRESS 


DELETIONS HAVE 
BEEN COMPLETED. 


UPDATE TO NEXT 


LAST COMTAB 
COMTAB ENTRY ENTRY 


YES 


FORMAT DOS DEL 
STATEMENT FOR 
PUB-X 


MOVE DEL 
STATEMENT TO 
DOS STORAGE 


RETURN 
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Flowchart 4C. IPL Add Routine (IIVADD Part 3 of 4) 


: FROM 4B/B3, 
4B/E2 


GET COMTAB-X 
ADDRESS 


GET DOS PUB 
TABLE ADDRESS 


ADDCHK20 


NULL DOS 
PUB ENTRY 


END OF DOS 
PUB TABLE 


COMTAB-X 


GET NEXT 
hi PUB COMTAB-X ENTRY 


YES GET OS DATE AND 
TIME 


T_NEXT DOS CONVERT _OS 
JULIAN DATE TO 


DOS MM/DD/YY 


GE 
PUB TABLE ENTRY 


FORMAT DOS SET 


STATEMENT 


PLACE SET 
STATEMENT IN 
DOS STORAGE 


RETURN 
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Flowchart 4D. IPL Add Routine (IIVADD Part 4 of 4) 


4D 
Bt 


FROM 4C/D1, 4C/E1 


SAVE COMTAB-X 


ADDRESS 


Ci ADDSTG C4 


YES NEW DEVICE 


CARD READER 


POINT TO 
2540R DEVICE 
TABLE ENTRY 


ADD2400 


T TRACK 
TAPE UNIT 


POINT TO 
2400T7T DEVICE 
TABLE ENTRY 


NEW DEVICE 
CARD PUNCH 


POINT TO 
2540P DEVICE 
TABLE ENTRY 


2400 DEVICE 


POINT _TO 
2400T9 DEVICE 
TABLE ENTRY 


NEW DEVICE 
PRINTER 


POINT TO 1403 
DEVICE TABLE 
ENTRY 


ADD3420 


7 TRACK 
TAPE UNIT 


POINT TO 
3420T7 DEVICE 
TABLE ENTRY 


NO 


POINT TO 
3420T9 DEVICE 
TABLE ENTRY 


FORMAT DOS ADD 
STATEMENT FROM PLACE ADD 
DEVICE TABLE STATEMENT IN 
ENTRY DOS STORAGE 


GET ADDRESS OF 


DEVICE TABLE RETURN 


DOSPUBIO 
J3 


COMTAB 
DEVTYP = 
TABLE DEVICE 
TYPE 


TIVMSG 2TA/AI 


ISSUES MESSAGE 
11V032]1 


GET NEXT DEVICE 
TABLE ENTRY 


YES 


END OF 
DEVICE TABLE 


YES 


RETURN 


) a 3 | 


ERROR RETURN TO 
TERMINATE 
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Open Routine (Flowcharts 5A-5D) 


Module name: IIVOPN 
Entry point name: IIVOPN, OPEN9S5 


Major functions: Opens Emulator-allocated dedicated resources 


dynamically 
Entered by: 
e IITVPCE 
e TIVIN2 
e ITIVPRP 
e TIVRTE 
Modules called: 
e ITIVGET 
e TIVMSG 
Exits to: 
e TIVABN 
e Returns to caller 
e TIVSTG 


OS macros issued: 


DCB 

EXCP 

WAIT 

OPEN TYPE=J 
LOAD 

RDJFCB 
IMGLIB 

SAVE 

DELETE 

DCBD 


Input: 

° Register 0 points to the COMTAB entry to be processed 
e Register 9 points to the local execution list 
e Register 10 points to DOS storage 

° Register 11 points to IIVCON 

Output: 

° COMTAB CTFLAG bit 7 is set on 

° Opened DCB 

e Formatted ITOB/formatted STGCON 

Return codes: 

e X'00'=unsuccessful open 

e X'04'=successful open 


° X'O04'=exit to IIVABN 
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Tables/work areas: 


COMTAB 

IOB 

JFCB 

DEB 

PUB 

EMUCONS 

DOS COMREG 

DOS low storage area 
DSCBs in VTOC 


Errors detected: 


Device not stageable 
Open was unsuccessful 


VTOC overlaps cylinder boundary 


Could not find PUB entry in the DOS PUB table during DOS IPL 


Volume contains OS password data sets 
Invalid FCB image 


OPEN for SYS1.IMAGELIB failed 


Messages requested: 


IIV0181 
IITVO211I 
ITVv023T 
IIVO24T 
IIVO 40D 
TIVO4IT 
IIV050D 
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Flowchart 


5A. 


Open Routine 


(IIVOPN Part 1 of 4) 


| 1VOPN 


ENTRY 


FROM _IIVIN2_ (CHART 3E), 
TIVPRP (CHART 21C), 
1TIVPCE (CHART 8J) 


GET ADDRESS OF 


COMTAB ENTRY 


C2 c3 C4 


NO NO YES 
OPEN BIT ON 


YES YES NO 


D4 
5B 
B2 


YES TELEPROCESSING 
DEVICE 


GET ADDRESS OF 
DCB 


OPEN40 
( TELEPROCESS- 


OPENI0 NO 
NG IEVICE) attra Ty a aes 


GET SEQUENT IAL 


GET 
READ JFCB veer enarae DCB LENGTH 


LENGTH 


CHANGE VOLUME GET _ADDRESS OF GET gore OF 


SERIAL NUMBER Leama meu 


BA 
SEQUENTIAL DCB 


: OPEN60 5D/A3 


GET DCB STORAGE 
AND FORMAT 


OPEN60 5D/A3 
GET DCB STORAGE 
AND FORMAT 


& 


YES 


(us) FCB SPECIFIED 
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Sa (DASD 


GET DASD DCB 
LENGTH 


GET ADDRESS _ OF 
BASIC DASD DCB 


OPEN60 5D/A3 


GET DCB STORAGE 
AND FORMAT 


SET JFCB DSNAME 
TO X*0404...° 


SET ALIGN BIT 


IN JFCUCSOP 
FIELD OF JFCB 


OPENI2 J5 (+) 


YES 


SET BLP_BIT 
ON IN JFCB 


Flowchart 5B. Open Routine (TIVOPN Part 2 of 4) 


5B 
© 


FROM 5A/C3 


B5 


GET STAGED OCB NO 1S_ THIS A 
LENGTH PRINTER 
YES 


C2 c5 


GET ADDRESS OF 
OUTPUT STAGED 
DCB 


OUTPUT INPUT OR 


OUTPUT 


GET ADDRESS OF 


OPEN Is 
INPUT _STAGED SYS1.1MAGELIB SYS1.[MAGELIB 
DCB OPEN 


OPEN60 5D/A3 


GET DCB STORAGE LOAD !1VPOV 
AND FORMAT 
NO 
E2 ey 
PLACE DOS CUU YES NO GET PUB TABLE BUILD FCB IMAGE 
IN STGCON 1PL COMPLETED ADDRESS FROM NAME 


DOS COMREG 


[IVMSG 2TA/AI 


YES LOAD FCB IMAGE 
ISSUES MESSAGE FROM 
11v0e31 SYS!|.1MAGELIB 


g 


IIVSTG 11A/A2 
EXIT 
VERIFY FCB 
IMAGE 


GET ADDRESS OF 
IIVSDT_ (STAGED 
DEVICE TABLE) 


LAST PUB 
TABLE ENTRY 


UPDATE TO NEXT COMTAB 

PUB TABLE ENTRY CUU=PUB CUU 
TO I[IVABN 
(CHART 26A)} 


YES 


GET NEXT_IIVSDT PLACE PUB TABLE DELETE FCB 
DEVICE ENTRY Ce Eaton IN IMAGE 


J5 


I IWMSG 2TA/AI 1IVMSG 2TA/AI 


YES NO 
ISSUES MESSAGE EXIT ISSUES MESSAGE 
[ivoeil L1Vo4t] 
TO TIVABN (CHART 26A) 
(xs ) YES 


Cor) 


TO |1VABN (CHART 26A) 


1S_FCB 
IMAGE GOOD 
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Flowchart 5C. Open Routine (IIVOPN Part 3 of 4) 


FROM 5A/J5 
FROM 5B/B5, 
58/J5 


rs 
- 


LOAD STAGED 
TRANSLATE TABLE 


SET ABEND 
BYPASS SWITCH 


TURN OFF 
ABEND BYPASS 
SWITCH 


OPEN DCB _FOR 
INPUT 


OPENSO Ce c3 c4 


FINISH _STGCON YES NO YES PLACE VTOC 
FORMATTING DASD DEVICE ADDRESS _IN 
CHANNEL PROGRAM 


NO 


Di 


FROM CHART CAUSES SIO 
APPENDAGE TO 
EXTEND THE DEB 
EXTENTS AND READS 
THE VTOC_ (FORMAT 
4) DSCS RECORD 
INTO STORAGE 


() Ny 
LIVMSG 2TA/AI 


INPUT 
ISSUES MESSAGE 
1IvVotél 


INPUT OR 
OUTPUT 
OCCURRED 


OUTPUT 


SET _ERROR 
RETURN 
CONDITION 


SET OPENED 
CONDITIONS 


SET ABEND 
BYPASS SWITCH 


E5 

NO 
EXCP GOOD 
YES 


F5 


I1I¥VMSG 2TA/AI 


OPEN DCB FOR RETURN NO 
OUTPUT ISSUES MESSAGE 
11vV050D 


VTOC WITHIN 
CYLINDER 
BOUNDARY 


ANY MORE 
DSCB'S 


INVALID 
REPLY USE 
OR NO 
FROM 5B/D4 (13 ) NO 


LIVMSG 2TA/AI 


ISSUES MESSAGE 
11¥040D 


EXCP_AND WAIT 
TO READ NEXT 
DSCB 


IDENTIFIER 
(FORMAT 1) 
DSCB 


SECURED 
DATA SET 


REPLY CONT 


OR CANCEL EXCP GOOD 


CANCEL YES NO 


S @ 
IIVMSG 2TA/AI 
YES 
OS DATA SET ISSUES MESSAGE 
11vo24l 
TO [IVABN 
(CHART 26A) 


150 DOS Emulator Logic 


Flowchart 5D. OPEN60 Routine (IIVOPN Part 4 of 4) 


FROM I|1IVOPN 
(CHARTS 5A, 5B) 


os 


LIVGET TA/A3 


GETMAIN FOR DCB 


FORMAT NEW DCB 
WITH BASIC DCB 


PLACE DD_ NAME 
IN DCB 


E3 


YES 


PLACE ECB 
ADDRESS IN 10B 


PLACE DCB 
ADDRESS IN 108 


PLACE 108 
ADDRESS IN DCB 


RETURN 
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OS PUB Table Build Routine (Flowcharts 6A-6F) 


Module name: IIVPUB : ) 
Entry point name: IIVPUB 
Major functions: 


e Maps DOS I/O control blocks to Emulator I/O control blocks by 
means of the OS PUB table 


e Issues initial Emulator prompt 
Entered by: IIVSVC 

Modules called: IIVGET, IIVMSG 
Exits to: 


e Caller 
e Return+4 to caller on error condition 


OS macros issued: 


e LOAD 

e STIMER 
e SAVE 

e RETURN 
Input: 


e Register 9 points to local execution list 
e Register 10 points to DOS storage ; 
e Register 11 points to IIVCON ) 


Output: Initial prompt 
Return codes: None 
Tables/work areas: 


Local execution list 
EMUCONS 

COMTAB 

DOS communications region 
DOS PUB table 

DOS storage 

OS PUB table 


Errors detected: 

e A DOS PUB entry did not exist 
e Devices not compatible 

e Device not stageable 


Messages requested: 


e ITVOO9T 
® IIVO1W7I 
e ITVO2II 
e IIVI00E 
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Flowchart 6A. 


OS PUB Table Build Routine (IIVPUB Part 1 of 6) 


11 VPUB 


ENTRY 


FROM LIVSVC (CHART 1 7A) 


GET DOS PUB 
ADDR 


ESS 


SAVE DOS PUB 
ADDRESS 


INITIALIZE DOS 
PUB ENTRY COUNT 


ADD_1! TO DOS 
PUB COUNTER 


LAST _PUB GET NEXT PUB 
ENTRY ENTRY 


YES 


CALCULATE 


STORAGE NEEDED 
FOR OS PUB 


1IVGET TA/A3 


OBTAIN OS PUB 
TABLE STORAGE 


INITIALIZE OS 


PUB TABLE 


6B 
BI 
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Flowchart 6B. OS PUB Table Build Routine (IIVPUB Part 2 of 6) 


GET_COMTAB 
ADDRESS 


GET _ DOS PUB 
TABLE ADDRESS 


6B 
DS5/FROM 6C/B4 
6C/F4, 6C/E4, 


6D/G3, 6D/G5 


LOBCHK 66 D) 


| OBCHK60 D2 D3 


COMTAB 
ENTRY FOR 
DOSLOG 


YES COMPUTE PUB 
ENTRY NUMBER 


DEVTYP = 
PUB_DEVIC 
TYPE 


COMTAB CUU 
= DOS PUB CUU 


YES 


TOBCHK65 


COMTAB FOR 
STAGED DEVICE 


GET NEXT DOS 
PUB ENTRY 


PUB 
IN 


COMPUTE COMTAB 
ENTRY NUMBER 


LAST PUB 


COMTAB 7 
TABLE ENTRY TRACK DEVICE 


SAVE COMTAB 


PUB_7T TRACK 
DEVICE ENTRY NUMBER I 
OSPUB 


UPDATE TO NEXT 


RETURN 


ERROR RETURN 


COMTAB ENTRY 


J5 


PUB_9 TRACK LAST COMTAB 
DEVICE ENTRY 


NO YES 


Y G 
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Flowchart 6C. OS PUB Table Build Routine (TIVPUB Part 3 of 6) 


FROM 6B/E3 


DOS DEVICE 
A 1403 


C2 


YES DOS DEVICE YES 
A 3410 


DOS DEVICE 
A 2400 


DEVICE 
3525P 


DOS DEVICE 
A 2540P 


3505 - 540R 


I IVMSG 2TA/At 


ISSUES MESSAGE 
1ivo1 


DEVICE A DOS DEVICE 
A2 
Tl 


RETURN+4 


ERROR RETURN 


Program Organization 155 


Flowchart 6D. OS PUB Table Build Routine (IIVPUB Part 4 of 6) 


6D 
Bi 


FROM 6B/E3 


MOVE PUB DEVICE 


TYPE TO COMTAB 


SYSOUT 
SPECIFIED 


SET 3525P 
DEVICE TYPE IN 
COMTAB 


SET 2520P 
DEVICE TYPE IN 
COMTAB 


2520RP DEVICE 


SET 1442P 
DEVICE TYPE IN 
COMT AB 


1442RP DEVICE 


GET ADDRESS OF 
LEVSOT 


G3 


11¥SDT PLACE STAGED 
DEVICE TYPE YES COMTAB LOAD STAGED TRANSLATE TABLE 
= COMTAB FLAGGED OPEN TRANSLATE TABLE ADDRESS_IN 
DEVTYP COMTAB 


68 
D5 


GET NEXT IIVSOT 
ENTRY 


LIVMSG 27A/AI 


YES 
ISSUES MESSAGE RETURN 
fivo2il 
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Flowchart 6E. OS 


1OBCHK 70 B2 


AVE CE AIDS YES 


Ss 
ADDRESS FOR S10 
ROUTINES 


PUB Table Build Routine (IIVPUB Part 5 of 6) 


%y ©) 


| OBCHK 75 B3 


FROM 6B/J5 


DOS COMREG 
EXTENSION 


NO NO 


YES 


c3 


DOS SUPPORT DOES DOS YES ISSUE SET TIME 
CE AIDS SUPPORT TIMER 


FOR ONE SECOND 


D2 


INDEXED 
SEQUENT | AL 
AND/OR DEVICE 


SHARING 
REQUESTED 


GET BG_SYSRDR 
LUB ADDRESS 
FROM DOS COMREG 


SAVE BG LUB 


LOAD IIVGR2 ADDRESS 


F2 


GET _ AR PIB 
ADDRESS 


DEVICE 
SHARING 
REQUESTED 


GET ADDRESS OF 
B-TRANSIENT 
AREA 


SAVE 
BEGINNING AND 
ENDING 
B-TRANSIENT 
ADDRESSES 


REQUESTED 


GET BG PIB 
LOAD ADDRESS 


lIVIS 
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Flowchart 6F. 
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OS PUB Table Build Routine (IIVPUB Part 6 of 6) 


FROM 6E/J3 


Be 


IS DOS 
SYSTEM AN MPS 


GET Fi AND Fe 
PIB ADDRESSES 


SAVE Ft AND 
ADDRESSES 


SAVE BG PIB 
ADDRESS 


GET ADJUSTMENT 
FACTOR 


[L1VMSG 2TA/AI 


ISSUE FIRST 
LINE OF PROMPT 


IIVIOOE 


He 


WAS A 
PROMPT = YES 


I IVMSG 27TA/AI 


ISSUE REPLY 
OPTIONS IIVIOOE 


DOS Emulator Logic 


GET DOSRES 
COMTAB 


SHARED VOLUME 


GET FIRST 
COMTAB 
EXTENSION 


GET LOW LIMIT 
CYLINDER ADDRESS 
FROM DEB AND PUT 
COMREG LABEL 
CYLINDER ADDRESS 


IN 


END_OF 

COMTAB 

EXTENSION 
CHAIN 


GET _NEXT COMTAB 
EXTENSION 


RETURN 


GETMAIN/FREEMAIN Routine (Flowchart 7A) 


Module name: IIVGET 
Entry point name: IIVGET 
Major functions: 


e Obtains dynamic storage 
e Frees storage 


Entered by: 


ITIVINT 
IIVIN2 
ITIVPUB 
IIVOPN 
IIVDVS 
IIvis 


Modules called: IIVMSG 
Exits to: 


e Returns to caller ; 
e IIVABN on error conditions 


OS macros issued: 


e GETMAIN 
e FREEMAIN 


e SAVE 
Input: 
GETMAIN 
e Register 0 - amount e 


of storage needed 


e Reqister 1 - zeros e 


Output: None 


FREEMAIN 


Register 0 - length of 
storage to be released 


Register 1 - address of 
storage to be released 


Return codes: xX'O4* on exit to IIVABN 


Tables/work areas: EMUCONS 


Errors detected: Storage not available 


Messages requested: ItIrv0d14T 
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Flowchart 7A. 


GETMAIN/FREEMAIN 


Routine (IIVGET) 


| | VGET 


ENTRY SaoM IIVINT (CHARTS 2D, 2E, 


F, 24), IIVIN2 {CHARTS 3D; 
3E}, 1 1VOPN (CHARTS 5Dy 

| 1VPUB (CHART 6A)+ LIVDV5 
(CHARTS 23A, 23E, 23U), 
IIVIS (CHARTS 24B, 24C) 
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DOS Emulator Logic 


B3 


TYPE FREE 
OPERAT ION 


GET 


ISSUE GETMAIN 


D3 


STORAGE 
AVAILABLE 


TIVMSG 27A/A\ 


ISSUES MESSAGE 
Ilvot4l 


EXIT 


TO ITIVABN (CHART 26A) 


ISSUE FREEMAIN 


YES INITIALIZE NEW 


STORAGE TO 
ZEROS 


RETURN 


RETURN 


Synchronous Interruptions 
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Program Check Executive Routine (Flowcharts 8A-8U) 


Module name: IIVPCE 


Entry point name: ITIIVPCE 


Major functions: 


162 


Checks for privileged operation interruption to determine if 
it is simulated. 


Checks for first program interruption to determine if it is an 
Operation exception interruption. 


Simulates all other program interruptions. 

SSMRTN simulates the SSM instruction. 

SSKRTN simulates the SSK instruction. 

ISKRTN simulates the ISK instruction. 

LPSWRTN simulates the LPSW instruction. 

Checks for first LPSW that causes control to pass to INTRPT. 


INTRPT checks for wait bit = 1 and enabled interruptions; if 
these conditions are met, INTRPT simulates the expected interruption. 


TCHRTN simulates the TCH instruction. 

TIORTN simulates the TIO instruction. 

HIORTN simulates the HIO instruction. 

CTLRTN simulates the LCTL and STCTL instructions. 

STIDPRTN simulates the STIDP instruction. 

If the DOS device is not staged or is not the DOS system 

console device, IIVPCE issues an OS EXCP macro for the intercepted 
DOS SIO, using DOS CCWs with adjusted addresses (from local to true). 


Initial DOS CCWs for seek and set file mask are not passed to OS. 


Stand-alone seek and sense operations are simulated as complete 
to DOS but not given to OS. 


Obtains the channel and unit address, the device entry index into 
COMTAB, and the absolute address of the device entry in COMTAB. 


Determines the absolute value of the BDDD portion of an instruction 
within the DOS partition or determines channel and unit address’ 
from I/O instruction. 


Dissects the ISK or SSK instruction to obtain corresponding 
addresses of R1 register and entry in ISK/SSK Table. 


STIDC instruction is ignored. 


SCKRTN simulates the DOS SCK instruction. Disables STCK instruction in the 
DOS Svc 34 routine. 


STCKRTN simulates the STCK instruction for DOS Svc 34. 


DOS Emulator Logic 


Entered by: 


DOS via a program interruption 


TIvepct 


Modules called: 


IIVCCW 
IIVMSG 
IIVOPN 
TIVABN 
LIVVIO 
TIVCHK 
TIVRCW 


Exits to: 


IIVLOG 
LIVSTG 
LIVRTE 
TIVABN 


OS macros issued: 


WAIT 
EXCP 
IOHALT 
POST 


Input: 


DOS registers 


Local execution list 


DOS program new PSW 


Pointer 
Pointer 
Pointer 


Pointer 


to instruction 
to local execution list 
to Emulator constants 


to DOS area 


Base register 


Pointer to current PUB in location REG3 


Pointer to CCB in location REG1 


Output: 


DOS program old PSW 


Base register 


Pointer 
Pointer 
Pointer 


Pointer 


to instruction 
to local execution list 
to DOS area 


to Emulator constants 
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e System mask in current PSW 

e Storage key value in ISK/SSK table 

e Storage key value in instruction register 
e Pointer to COMTAB entry for channel 

° Index of channel within COMTAB 


e Channel and unit address 


e Absolute address of Location in DOS area or channel and unit 


address from I/O instruction 
Return codes: Error code 12 for IIVABN 
Tables/work areas: 
Local execution list 
e Current PSW 


e ISK/SSK table 


e COMTAB 
e DCB 
e ECB 
e CSW 
e CAW 
e IOB 
e CCW 


© DOS I/O old PSW 

e DOS I/O new PSW 

e Post ECB list 

e TEB 

° PUB 

Errors detected: 

@ For nondedicated device - invalid seek address 
e Invalid or no IPL device specified 

e For IBM 2321 - no seek or no bin number defined 
Messages requested: 


e IIV160A 
e IIV2631 
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Flowchart 8A. Program Check Executive Routine (IIVPCE Part 1 of 19) 


PCPRIVOP A4 


ENTRY 


PSW IN 
PROBLEM STATE 


FROM DOS VIA A 
PROGRAM CHECK; 
I}IVPCI (CHART 31C} NO 


FIRSTPC B3 


NO LOAD ADDRESS OF 


CAUSED BY 
ZEROED OP 
CODE 


PRIVILEGED OP 
CODE 


ci c4 


LPSWRTN 8D/A2 


YES 
SIMULATE LPSW 


L) 
SIORTN® Bu/Al 


SIMULATE SIO 


TCHRTN 8E/Az2 


SIMULATE TCH 


SSMRTN 8C/A3 


SIMULATE SSM 


TIORTN® 8F/A2 


SIMULATE TIO 


HIORTN 8H/A2 


SIMULATE HIO 


SSKRTN 8C/A2 


SIMULATE SSK 


e 


ISKRTN 8C/A4 


SIMULATE ISK 


1S PROGRAM 
CHECK FOR 
PRIVILEGED 
OPERATION 


TURN FIRST PC 
SWITCH OFF AND 
CHANGE CONDITION 
CODE_IN PSW TO 
ADDRESSING 


OP CODE 
LPSW X*82° 


NO 
PCOO D1 


OP CODE S10 


FIRST 
PROGRAM CHECK X*9C* 


MOVE DOS ENDING 
YES STORAGE ADDRESS 
TO DOS REGISTER 

{ 


NO 


El 


ADDRESSING 
EXCEPTION 


YES (ca ) 


NO 


Fi 


STCKRTN 8U/A3 


STORE CLOCK 
SUBROUT | NE 


SPECIAL OP 
CODE 


NO 


YES 


SET TO 
PRIVILEGED 
OPERATION 


FROM 8S/F3, 


NO 
8U/B3, 
8B/BI, 
8B/G! H3 


MOVE _PSW TO DOS 
PROGRAM OLD PSW 
LOCATED IN 
X'28' OF DOS 
AREA 


MOVE DOS 
eRoenan NEW PSW 


T OCAL 
EXECUTION LIST 
LOCATION 


OP CODE SSK 


X° OB’ 


LOAD ADDRESS AT 
|} IVRTE ROUTINE 


MAP PROGRAM 
CHECK TO SVC QO: 
SWAP SVC PSW°S 


CODE ISK 


TO TIVRT 

1IVRTER2 (CHART 

20B) 8B 

BI 

*1F DEVICE 1S A CONSOLE, 
EXIT IS TO 11VLOG, IF AN 
ERROR IS DETECTED, EXIT 
1S TO IIVABN. 
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Flowchart 8B. Program Check Executive Routine (IIVPCE Part 2 of 19) 


8B 
Ny 
FROM 8A/K4 


Bl 


DOS RELEASE NO 
2T 


YES 


ci 


CTLRTN 8T/A‘ 


SIMULATE LOAD 
CONTROL 


OP CODE YES 
LCTL (X*BT*) 


CTLRTN 8&T/Al 


SIMULATE STORE 
CONTROL 


OP CODE 
STCTL (X'B6") 


STIDPRTN 8S/A4 


SIMULATE STORE 
cPU ID 


OP CODE 
STIDP 
(X*B202" ) 


SCKRTN BU/AI 


SET CLOCK 
SUBROUT INE 


OP CODE SCK 
(X*B204°) 


OP CODE 
STiIDC 
{X*B203") 


SET CONDITION 
CODE TO ZERO 


NO 
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Flowchart 8C. 


SSK, SSM, and ISK Simulation Subroutines (IIVPCE Part 3 of 


SSKRTN 


FROM 


FINDKEY 8S/A2 


GET ADDRESS OF Ri 
REGISTER_AND 
ADDRESS OF ENTRY IN 
ISK/SSK TABLE 


MOVE STORAGE 
KEY VALUE FROM 
4TH BYTE OF 
REGISTER TO 
ISK/SSK TABLE 


RETURN 


]IVPCE 
(CHART 8A) 


SSMRTN 


FROM | 1VPCE 
(CHART 8A) 


FINDADDR 8R/A2 


GET ADDRESS OF 
BYTE TO BE NEW 
SYSTEM MASK 


MOVE NEW SYSTEM 
MASK TO FIRST 
BYTE OF CURRENT 
PSW 


RETURN 


FROM IIVPCE 
(CHART 8A) 


FINDKEY &5/A2 


GET ADDRESS OF RI 
REGISTER AND 
ADDRESS OF ENTRY IN 
ISK/SSK TABLE 


MOVE STORAGE 
KEY FROM 
ISK/SSK TABLE 


TO 4TH BYTE OF 
REGISTER 


RETURN 
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Flowchart 8D. LPSW Simulation Subroutine (IIVPCE Part 4 of 19) 


LPSWRTN 
ENTRY 


FROM IIVPCE 
(CHART 8A} 


INTRPT 
FINDADDR 8R/A2 5 


GET ADDRESS OF WAIT BIT ON 
PSW TO BE 
LOADED 


MOVE PSW_TO INTERRUPTS 
ENABLED 


LIST CURRENT 
PSW 


YES 


D2 


FIRST LOAD YES TURN OFF RETURN 
PSW FIRST _LPSW 
SWITCH 
NO 
E4 INTRPTEX 


MOVE CURRENT PSW TO 


RETURN 


EXTERNAL YES DOS STORAGE AND 
INTERRUPT TO BE MOVE DOS EXTERNAL 
SIMULATED 


NEW PSW TO CURRENT 
PSW 


NO 


MOVE OOS IPL 
RETURN 


MOVE CURRENT PSW TO 


PSW TO CURRENT PSW 


SYMBOL TABLE 


ZERO CSW AND 
LIST-LOCAL TURN_ON DEVICE 
END BIT 


EXECUTION LIST 


J4 


DOSIPL 
DEVICE= 
CONSOLE 


YES 


TURN ON 
ATTENTION BIT 
IN CSW 


NO 


RETURN RETURN 


168 DOS Emulator Logic 


Flowchart 


SE. 


FROM I|IVPCE (CHART 8A) 


FINDCHAN &8Q/A3 


CHECK FOR CHANNEL 
SUPPORTED, GET 
INDEX AND ADDRESS 


OF FIRST DEVICE ON 
CHANNEL IN COMTAB 


er-4 


CHANNEL NO 


SUPPORTED 2 RETURN 
YES 
D2 D3 


YES WAITING FOR 


DEVICE END 


INCREMENT INDEX 
AND ADDRESS 
REGISTERS TO 
NEXT ENTRY IN 
COMTAB 


NO 


MORE 
DEVICES ON 
CHANNEL 


NO 


SET CURRENT 
PSW CONDITION 
CODE TO CHANNEL 
AVAILABLE 


RETURN 


TCH Simulation Subroutine (IIVPCE Part 5 of 19) 


SET CURRENT 
PSW CONDITION 
CODE TO CHANNEL 

BUSY (CC=2) 


RETURN 
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Flowchart 8F. TIO Simulation Subroutine 
T LORIN A 
ENTRY 
FROM ILIVPCE 
(CHART 8A) 
FINDCHAN 8Q/A3 
ND N CODE 
GET INDEX AND T ZED TO 
ADDRESS OF FIRST were ATIONAL 
UNIT ON CHANNEL IN 
COMTAB 
C2 
CHANNEL NO 
SUPPORTED RETURN 
YES 
TIOSRCH D2 D3 
YES DEVICE 
-_: 
STEP INDEX AND RETURN 
ADDRESS TO NEXT 
UNIT IN COMTAB 
H3 
WTO READY 
TO PROCESS 
NO 
TIOXLG 
SET CURRENT 
PSW CONDITION 
CODE TO BUSY 
(CC=02) 
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(IIVPCE 


YES 


Part 6 of 19) 


SET CURRENT 
PSW COND! TION 
CODE TO 

AVAILABLE 
(CC=00) 


D4 
YES | 8G 
B2 
NO 
E4 
YES («2 } 
NO 
F4 


DEVICE DOS 
SYSLOG 


NO 
RETURN 


YES 


TIOXLOG G4 


LOG 1/0 _IN 
PROCESS 


NO 
RETURN 


SET CURRENT 
PSW CONDITION 


EXIT 


TO IIVLOG AT 
I |VLOGR2 
(CHART {0E) 


Cor) 


TO TIVLOG AT 
OGRI 
NO (CHART 10C) 


(CC=01) 


4 


WTOR READY 
TO PROCESS 


YES 


RETURN 


Flowchart 


8G. 


TIO Simulation Subroutine (IIVPCE Part 7 of 19) 


FROM 8F/D4 


Is 1/0 
POSTED 
COMPLETE 


SCAN POST ECB 
TABLE FOR AN 
ENTRY FOR 
DEVICE 


DEVICE 
ENTRY FOUND 


HAS IT 
ALREADY BEEN 


PROCESSED 


MOVE ECB CODE 


TO PARAMETER 
REGISTER 


WAIT FOR 1/0 
COMPLET ION 


DECREMENT NUMBER OF 
s10* MOVE ECB 


O'S 
CODE TO PARAMETER 
REGISTER, CLEAR ECB 


ILIVCHK 9A/A2 


GET 1/0 CSW 
PROCESSED 


SET CURRENT 


RETURN 
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Flowchart 8H. 
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HIO Simulation Subroutine 


Ht ORTN 
ENTRY 


FROM IIVPCE 
(CHART 8A} 


~ 
« 


FINDCHAN 8Q/A3 


GET INDEX TO FIRST 


DEVICE ON CHANNEL 
IN COMTAB 


C2 


NO CHANNEL 
SUPPORTED 


RETURN 


YES 


D2 


D 
STEP_TO NEXT 
UNIT AND_TO 
NEXT COMTAB 
ENTRY 
YES 


YES 


HIOTST 8H/A4 


TEST DEVICE STATUS; 
ISSUE ILOHALT IF 
NEEDED 


SET CONDITION 
CODE TO ZERO IF 
OPERAT [ONAL 


Fe 


RETURN 


DEVICE NO 
OPERATIONAL 


RETURN 


SET CONDITION 
CODE ‘Ol* (CSW 
STORED} 


SET_CSW STATUS NORMAL 
TO ZEROS {OHALT RETURN 
NO 
RETURN SET CONDITION 
CODE ‘*03* (NOT 
OPERATIONAL ) 


DOS Emulator Logic 


(IIVPCE Part 8 of 19) 


HIQ A4 


FROM 8H/E2 


B4 


DEVICE NO 
OPERAT I ONAL 


YES 


CLEAR CONDITION 
CODE 


> 


D4 
NO 
YES 

RETURN 


RETURN 


RETURN 


Flowchart 8J. 


SLORTN A 
ENTRY 
FROM LIVPCE 
{CHART 8A) 
Bi $[02 B2 
PUB OBTAIN INDEX TO 
NO INDICATES NO COMTAB VIA 
CURRENT PUB 
INDEX 


IPL_TIME OR 
CE AIDS NOT OPER- 
AT |ONAL 


YES 


FINDCHAN 8Q/A3 


NO 
GET CUU FROM 
DOS SIO 


GET INDEX TO 
COMTAB VIA 


ADJUST POINTER 
TO COMTAB ENTRY 
FOR BIN NUMBER 


SEARCH ON CUU 


EI 
YES HAD MATCH 
ON BIN NUMBER 
NO 
Fi 


YES 


SET ERROR CODE 


$103 G3 


EXIT 


NOT OPERATIONAL 
(CC = 03) TO 


1S DATA SET 
OPEN 


TO I1IVABN 
(CHART 26A) 


RETURN 


YES 


EXIT 


TO LIVLOG 
(CHART 1t0A} 


NO 


SIO Subroutine (IIVPCE Part 9 of 19) 


SET ERROR CODE 
= 24 


EXIT 


TO !1VABN 
(CHART 26A) 


$104 


WAS DATA 
SET OPENED 


{IVOPN 5A/A2 


OPEN DATA SET 


J4 


YES 


NO 


Program 


SET PSW 
CONDITION CODE 
TO *02° 


RETURN 
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Flowchart 8K. SIO and SEERKTEST Subroutines (IIVPCE Part 10 of 19) 


SEE 


BK 
Bi 


FROM 8J/J4 


FROM 8K/J4 


Bt 


1S THIS YES COUNT NUMBER OF 


STAGED DEVICE 


START 1/O0°S 


SET NULL RETURN 


NO 


SET ADJUSTED 
POINTER TO SEEK 
ADDRESS (10B} 


SAVE DOS KEY IN EXIT 
COMTAB 


TO IIVSTG 
(CHART 11A) 


RETURN 


SET IOB FOR 
DATA CHAINING 


Et 


NO 


HAVE A CCB 


COMMAND 
CHAIN RETRY 


USER ERROR 
RECOVERY 


SET_1O0B FOR FROM 
DATA AND SET _|OB FOR 8N/DI, 

COMMAND COMMAND 8N/K4 
CHAINING CHAINING 


YES 
WAIT MACRO NOP FLAG ON 
NO 

CANCEL NOP SEEKTEST 8K/A4 

TURN OFF NOP YES BL 

FLAG, CLEAR DASD DEVICE TEST IF FIRST Bt 
ECB, DECREMENT CCw IS SEEK 
NUMBER OF SIO'S 
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Flowchart 8L. SIO Subroutine (TIVPCE 


BL 
Bl 


FROM 8K/ J4 


Bl 


NO 


YES 


CLEAR |0B 


SENSE AND (SW 


DI 


VALID SEEK 
ADDRESS 


YES 


NO 


SET SEEK-CHECK 

IN IOBSNS, SET 

UNIT-CHECK IN 
|OBSTAT 


CCW ADDRESS + 8 
TO 10B CSW, 
‘OR' IN 
CHANNEL, DEVICE 
END STATUS 


TURN_*NORELOC’ 
FLAG ON 


SET NORMAL 
COMPLETION 
(X'TF*) IN ECB 


DATA 


STAND 
SE 


INDEXED 
SEQUENT LAL 


Ba 


SET 


NO 


D2 


ALONE 
EK 


YES 


YES 


NO 


Part 11 


MOVE MACRO TYPE 


AND DTF ADDRESS 
ISAM TABLE 


ISAM SHARED 


SEEKDVS 8P/A2 


SHARED DEVICE 
SEEK 


SEEK ADDRESS TO 
10B 


of 19) 


6L 
B4f FROM 8M/J1, 
8N/D5 


RETURN 


SET FILE MASK 
TO COMTAB 


POINT TO USER'S 
TIC-TO ADDRESS 
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Flowchart 8M. SIO Subroutine (IIVPCE Part 12 of 19) 


8M 
Bl 
FROM 8K/J3 
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B4 
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SET I|10B 
CHAINING TO 
*DATA* AND 

* COMMAND * 


Flowchart 8N. 


SIO Subroutine 
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SET SENSE 
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YES SET IOBSENSE TO 
NOP FLAG ON INTERVENTION 
REQUIRED 
NO 


STOSNQ 
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FILE 
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Kt 
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NO 
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MOVE SENSE TO 
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ZERO_|OB8SENSE 
BYTES 


K3 
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COMMAND 
CHAINED 


(IIVPCE Part 13 of 19) 


STORE CCW +8 IN 
COMCAW 


COMTAB 


POST ECB 
COMPLETE 


CREATE POST ECB 
TABLE rh as FOR 


INCREMENT PASS 


SENSE OPCODE 


XY 
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Flowchart 8P. SEEKDVS Subroutine (IIVPCE Part 14 of 19) 


ENTRY 


FROM I 1IVPCE 
(CHART 8L) 


SEEKO500 B4 
Ss KOR OS ps 


TIV¥IO 25A/A 


CHECK FOR 1/0 
TO vTOC 


sae TO pans 
EXTENSION ENTRY 


MORE COMTAB 
EXTENSIONS 
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DOS OPEN 
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EXTENT NUMBER YES 
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TEST RETURN YES 
CODE =0 


DOS CAW KEY TEST RETURN YES 
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COMTAB DCB PRESENT 


IIYMSG 2TA/AI 


ECB ADDRESS TO SPLIT SET SPLIT IS SEEK FOR 
108 CYLINDER CYLINDER CCHHOO0O00 ISSUES MESSAGE 
INDICATOR 11V¥2631 


SEEKO300 ¥ F2 SEEK0400 
SEEK CHECK TO 
RETURN SEEK BIN No 1OBSNS, UNIT 
NUMBER = DEB EXCEPTION TO 
BIN STATUS 
SEEK 
ADDRESS IN 1S ADDRESS 
CYLINDER ZERO 
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DASD ADDRESS 


GET NEXT 
EXTENSION 
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Flowchart 8Q. FINDCHAN Subroutine (IIVPCE Part 15 of 19) 


FROM 11VPCE 
(CHARTS 8E, &F, 
8H 8J) 


FINDADOR 8R/A2 
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a 
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Flowchart 8R. FINDADDR Subroutine (IIVPCF Part 16 of 19) 
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D2 
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ADD BASE 
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NO 


ADD RELOCATION 
FACTOR TO SUM OF 
BASE REGISTER 
CONTENTS AND 
DISPLACEMENT 
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Flowchart 


8s. 


ENTRY 


FROM |LIVPCE 
(CHART &8C} 


SEPARATE Ri AND 
R2 REGISTER 
NUMBERS 


GET ADDRESS IN 
REGISTER SAVE AREA 
OF REGISTER R1_ INTO 
PARAMETER REGISTER 


GET ADDRESS IN 
REGISTER SAVE AREA 
OF REGISTER Re2 TO 
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USE REGISTER 
VALUE TO 
GENERATE INDEX 
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TABLE 


F2 


SET CURRENT PSW 

INTERRUPT CODE TO 

ADDRESSING PROGRAM 
CHECK 


1S ADDRESS 
LOCATION IN DOS 
STORAGE 


NO 


YES 


GENERATE ADDRESS OF 
STORAGE RETURN 
ENTRY FOR THIS 


BLOCK OF STORAGE 


RETURN 


FINDKEY and Store CPU ID Subroutines (IIVPCE Part 17 of 19) 


FROM _ LIVPCE 
(CHART 8B) 


FINDADDR 8R/A2 


GET DOS MAIN 
STORAGE ADDRESS 


MOVE CPU ID 
FROM EMUCONS TO 
DOS MAIN 
STORAGE 


RETURN 
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Flowchart 8T. lLoad/Store Control Register Subroutine (IIVPCE 


FROM IIVPCE (CHART 8B) 
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INSTRUCTION 


WRAP AROUND YES SET WRAP SWITCH 
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MOVE 
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NO 


MOVE DATA FROM 
DOS TO EMUCONS 
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EMUCONS TO DOS 


KI 


NO 


WRAP SWITCH 
SET RETURN 


YES 
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ADJUST DOS MAIN 
STORAGE POINTER 
RESET WRAP 
SWITCH 


ISOLATE R3 
FIELD OF 
INSTRUCT ION 


SET RI TO 


CONTROL 
REGISTER ZERO 


Part 18 of 19) 


Flowchart 8. 


FROM _IIVPCE 
(CHART 8B) 


SET CONDITION 


CODE TO 
LEX 


FINDADDR 8R/A2 


GET DOS 
MA IN-STORAGE 
ADDRESS 


STORE CLOCK 


COMPUTE 
TIME 
DIFFERENCE 
BETWEEN OS 
AND DOS 


SAVE_1IN EMUCONS 


(TDELTA) 


GI 


DOS STCK 
ALREADY 
DISABLED 


YES 


DOS STCK 
FOUND 


MOVE ZERO INTO 
STCK OP CODE 


SAVE _MAIN- 
STORAGE ADDRESS 
TCK 


QF S 
INSTRUCTION 


RETURN 


Set Clock, Store Clock Subroutines (IIVPCE 


ENTRY 


FROM I|IVPCE 
(CHART 8A} 


B3 


NO 


YES 


ADJUST LEX PSW 
INSTRUCT ION 


ADDRESS TO NEXT 
INSTRUCTION 


FINDADDR 8R/A2 


GET DOS 
MA IN-STORAGE 
ADDRESS 


STORE CLOCK IN 
DOS AREA 


F3 


SET 


CLOCK 
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ADJUST DOS 
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BY TIME 
DIFFERENCE 
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RETURN 


Part 19 of 19) 


STCK 
CONDITION CODE 
IN LEX PSW 
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Check I/O Routine (Flowcharts 9A-9D) 


Module name: IIVCHK J 
Entry point name: ITIVCHK 

Major functions: 

e Posts the CSW to DOS at I/0 interruption 


° If permanent error occurs, posts high error count to DOS to 
bypass DOS error recovery procedures 


° Readjusts DOS CCWs from true to local addresses 


e Provides DOS label cylinder address when DOS system residence volume 
is shared 


Entered from: 


e IIVRTE 
e ITVPCE 


Modules called: 


Tivecw 
TIVABN (if invalid ccw) 
IIVMSG 
TIVRCW 


Exits to: 


° Caller ) 


OS macros issued: EXCP (to issue NOP) 


Input: 

e Local execution list 
e Pointer to EMUCONS 

® Pointer to DOS area 
e Base register 


Output: 
e DOS CSW posted 


e High error count (254) posted to DOS PUB table (or TEB or TEBV, 
if appropriate) 


e IOB sense bytes 
® IOB status bits 


e DOS label cylinder address in DOS input area when DOS system directory 
record 1 read 


Return codes: 


Register 15 - 0 Simulate I/O interruption 


4 ignore current entry in post ECB list and get next entry 
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Tables/work areas: 


TEB 

COMTAB 

IOB 

Local execution list 

DOS communications region 
DOS PUB 


Errors detected: An error detected by TIVCCW or IIVRCW causes this module to pass 
control to IIVABN. 


Messages requested: IIV160A 
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Flowchart 9A. Check I/O Routine (TIVCHK Part 1 of 4) 


ENTRY 


FROM 


LIVPCE (CHART 8G), 


LIVRTE (CHART 20C) 


ESTABL|SH 


ADDRESSABILITY 


C2 


DEVICE IN NO 


USE BIT ON 


YES 


TURN DEVICE 
IN USE BIT OFF 


Ee 
YES 
NO 
Fa 
NO 
YES 
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CHECKOO1 C3 


DEVICE END YES TURN DEVICE MOVE CSW WITH 
BIT ON END_AND_ NOP DEVICE END BIT 
BITS OFF ON TO DOS CORE 
NO 
SET RETURN CODE 
OF O_IN 
REGISTER 15 
CHECKO00 F3 F5 
CB 
YES TURN NOP CODE °*44° 
SWITCH OFF ( INTERCEPTED) 
STATUS 


NO 


CHECKO02 G3 


NO 
RELOCATION 
BIT ON 


NO 9B 
Be 


YES 


CLEAR_10B SENSE 
BYTES 


Flowchart 9B. 


Check 
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11VCCW I5A/A1 
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ADDRESSES TO 
Loc 
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D2 
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SUPPORTED 
DEVICE 
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SIXTH ADDRESSES 
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START / STOP 
DEVICE CHAIN 
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SEVENTH CCW 
ADDRESS TO 
LOCAL 
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OR 
AL 
C2 
NO 
YES 


I/O Routine (IIVCHK Part 2 of 4) 


1IVRCW 34A/Al 


cH * Be FR 


IIVABN 26A/A2 


ERROR ROUTINE 
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Flowchart 9C. 


188 
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CSW ADDRESS 
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CSW ADDRESS 
TRUE 


LOAD FIRST DOS 
CCW ADDRESS, - 
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E2 


ADJUST CSW 
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NO 
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Fe 


MOVE LOCAL 
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RECORD | 


!S_ NEW 
LABEL CYLINDER 
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MOVE LABEL 
CYLINDER 
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INPUT AREA 
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NO 


B3 


CHANNEL END 
ONLY 


SET NOP AND 
DEVICE IN USE 
BITS ON 


CHECKO04 D3 


NO 


NO 
DASD DEVICE 


YES 


E3 


READ 

HOME 
ADDRESS 

RECORD 


ZERO 


READ 


YES 


F3 


ON 
ALTERNATE 
TRACK 


MOVE SEEK 
ADDRESS FROM 
10B TO READ RO 
AREA 


Check T/O Routine (IIVCHK Part 3 of 4) 


QUEUE UP AN 


INTERRUPT IN 
FIFO TABLE 


FROM 9A/G5 


RWUCHK ¥ 65 


NO | 9D 
B 
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c5 


REWIND- 
UNLOAD BEEN 
ISSUED 


r63(cs) 


NO 


D5 


YES WAS LAST 
CcW A REWIND- 


UNLOAD 


NO 


SET 
REW IND-UNLOAD 
BIT ON 


G5 


1S DEVICE 
STILL BUSY 


YES 


NO 


SET DEVICE 
END BIT ON. 


SET 
REW I NOD-UNLOAD, 
BIT OFF 


J5 


1S "WAITING FOR 
DEVICE READY BIT 


NO 


YES 


SET NOP BIT ON 


Flowchart 9D. Check I/O Routine 
9D 
Be 
FROM 9C/B5 
CHECKO040 Be 
YES 
BTAM DEVICE 
FROM NO 
9C/Je2, (ss ) 
9C/F3, 
9C/G3, CHECKO50 C2 
9C/E5, 
9C/G5, 
9C/E2, 
9C/Fe2, 
9C/G2, 
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ECB CODE ‘7F* 
COMMAND 
AND DATA 


CHAINING BITS 
ON IN 10B 


Fe 


<> 


NO 


SET DEVICE 
END BIT ON IN 
DOS CSW 


GET ADJUSTED 
(TRUE) ADDRESS 
OF PUB 


Ke 


(IIVCHK Part 4 of 4) 


B3 


DOS HAVE 
TEB'S 


DOS HAVE 
TEBV’'S 


CHECK090 E3 


NOP BIT ON 


CHECKQO? 


INCREMENT SIO 


COUNTER 


HIGH ERROR 
COUNT TO PUB TO 
BYPASS DOS ERPS 


ISSUE NOP 
EXCP TO DEVICE 


YES 


HIGH ER 
COUNT TO 
BYPASS DO 


HIGH ER 


COUNT TO TEBV 


TO BYPAS 
ERPS 


CHECK !00 


READY BI 


TIVMSG 27A/A1 


ISSUE MESSAGE 
VI6GOA 


NOT_RE 
BIT O 


TURN_NO 


ROR 
TEB TO 
S ERPS 


"NOT READY‘ 
BIT ON 


ROR 
TURN_ 'NOT 
S DOS 


READY’ BIT OFF, 
TURN NOP BIT ON 


FROM 9C/K5 
E4 
FROM 9A/C5 
ADY 9A/H2, 9B/¢3, 
N 9C/H1, 9C/K4 


e 
T OFF 


SET RETURN CODE 
OF FOUR IN 
REGISTER 15 


FROM 
9A/D3 


RESTORE CALLERS 
REGISTERS 


RETURN 
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Interpretive SYSLOG Routine (Flowcharts 10A-10E) 


Module name: IIVLOG 


Entry point name: 


e IIVLOG 

e TIVLOGR1 
e TIVLOGR2 
e IIVLOGR3 


Major functions: Interprets keyboard-printer CCW chains and issues 
WTO or WTOR macros as required 


Entered from: 


e TIVPCE 
e TIVRTE 


Modules called: 


e TIVAWV 
e ITVCWV 
Exits to: 

e IIVPCE 
e TIVRTE 


OS macros issued: 


e WTO 
e WTOR 
Input: 


e Pointer to DOSCORE 

e Pointer to Emulator constants (IIVCON) 

° Pointer to local execution list 

e Replies to WTOR issued by this module 

Output: 

e WTO/WTOR messages requested by DOS supervisor and/or problem programs 
e Updated DOS PSW in local execution list 

e Updated DOS CCW data areas 

e Updated DOS CSW 


Return codes: None 
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Tables/work areas: 


e DOSCORE: 
CAW 
I/O old PSW 
I/O new PSW 
ccW strings 
CcW data areas 
CCW 


e COMTAB for DOSLOG: LOGIOB (dummy IOB for DOS SYSLOG device) 


e Local execution list: DOS current PSW 


Errors detected: CAW/CCW errors as detected by IIVAWV and ITVCWV 


Messages issued: 


e IIVOOOA 
e IIVOOOL 
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Flowchart 10A. Interpretive SYSLOG 


FROM JIVPCE 
(CHART 8J) (se ) 
S LOGIO4 B4 
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YES 


YES 


Routine (IIVLOG Part 1 of 5) 


BI 


SET PROGRAM 

CHECK BIT IN 

10B ata BYTE 
N 


H5 


PREVIOUS 
LOG FLAGS 
ZERO 


NO 


SET CURRENT 
PSW CONDITION 
CODE TO | 


Flowchart 10B. 


{0B 
Biy FROM 


LOGIOIO Bi 


PREVIOUS 
DATA CHAIN 
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NO PREVIOUS 


WTO FLAG ON 


SET PREVIOUS 
WTQ FLAG OFF 


PREVIOUS 
CODE NO AUTO 


WTQ ROUTINE 
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SUBTRACT 
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SET MESSAGE 
LENGTH TO 
MAXIMUM LENGTH 
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Interpretive SYSLOG Routine (IIVLOG Part 2 of 5) 
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Flowchart 10C. IIVLOGR1 Subroutine (IIVLOG Part 3 of 5) 


FROM 10A/D4 


GET TOTAL 
LENGTH FROM CCW 


GET DATA 
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E! 
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Y 
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FROM [LIVRTE (CHART 20C) 
[I IVPCE (CHART 8F) 
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Flowchart 10D. 
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(CHART 
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AREA 
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ww 


Flowchart 10E. IIVLOGR2 Subroutine (IIVLOG Part 5 of 5) 
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DATA ADDRESS 


AND FLAGS 


FROM IIVRTE 
(CHART 20C) 
TEVPCE (CHART 
BF} 
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1oCcfJi, SET SYSLOG 
toDd/F2 PREVIOUS NO PREVIOUS NO SET CE BIT IN INTERRUPT 

LOG FLAGS LOG FLAGS 10B STATUS BYTE PENDING FLAG 

ZERO ZERO ON OFF 
D3 
SET CURRENT SET CURRENT PREVIOUS YES POST DOS CSW 
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CODE TO | 


PSW CONDITION WTO FLAG ON 


CODE TO 0 


FROM IOB 


LOGIO61 Et 


OG1O44 
LOGOUT2 {0D/A4 


MOVE DOS 
WTO ROUTINE CURRENT PSW TO 
DOS 1/0 OLD PSW 


LOG Loéé 


SET SYSLOG 
INTERRUPT 
PENDING FLAG ON 


CURRENT 
WTOR FLAG ON 


CURRENT WTO 
FLAG ON 


NO 


LOGI 065 F3 


CLEAR _10B 
SENSE BYTE 


ROUTE 
SWITCH ON 


YES 


MOVE DOS 1/0 
NEW PSW TO DOS 
CURRENT PSW 


GET NEXT CCW 


ADDRESS 


YES 


YES POST DOS CSW 
FROM 10B 


Ht 


CURRENT 
CHAIN FLAGS 
OFF 


NO 


SET PREV1IOUS EXIT 
LOG CODE AND 
LOG FLAGS 
TO JIVRTE AT 
LIVRTER2 
(CHART 20B) 
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Staged I/O Routine (Flowcharts 11A-11N) 


Module name: IIVSTG 
Entry point names: 


ITIVSTG 
EODA 
SYNA 
STGTIO300 


Major functions: 


e Furnishes the interface between the DOS Emulator and the spooling 
facilities (temporary data sets) provided for unit record devices by OS 


e During initialization creates an Emulator forms-control image for 
Staged printers from an OS FCB image 


e Intercepts DOS FCB load for 3211 and recreates the Emulator 
forms control image 


@ Intercepts the DOS READ FCB channel command and builds an FCB in DOS main 
storage from the Emulator forms control image 


D Intercepts the DOS CHECK READ channel command and computes and places the 
value of the FCB address register in DOS main storage 


Entered by: 


LIIVPCE 

TIVOPN 

OS (QSAM) upon end of data 

OS (QSAM) upon occurrence of synchronous error 


Modules called: 


e LIVAWV 
e ITVCWV 
e IIVPOV 
e IIT VMSG 
Exits to: 

e ITIVRTE 


e OS (QSAM) 
OS macros issued: 


PUT 

DCBD 

GET 

SAVE 
RETURN 
GETMAIN 
FREEMAIN 
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Input: 


e Data is passed to DOS following an input request 


e Register 0 contains the entry number into COMTAB for this I/0 
request. Zero indicates the first entry. 


e Register 10 contains the starting address of DOS 
e Register 11 contains the address of IIVCON 

e Register 14 contains the address of TIVRTER2 

° The OS FCB image is passed from the SYS1.IMAGELIB 
Output: 


e Output data from DOS that is written out to temporary data 
sets that are later processed by the Operating System's output writer 


° Emulator forms-control image 


° Operator information messages that indicate unusual occurrences 
(such as SYNAD conditions) 


Return codes: None 

Tables/work areas: 

e DOSCORE - DOS low storage area 

e Local execution list , 
e COMTAB - 
° STGCON - dummy IOB area 

e DOS CCWs 

e Emulator forms-control image 

Errors detected: 

e SYNAD subroutine is entered after a permanent I/O error 

e Program check bit set in CSW 

6 Unit check bit set in CSW if error detected in OS FCB image 

e Invalid command sequences for staged 2540 Reader 

° Command reject condition for all staged devices 

Messages requested or issued: 


e TIV140I 
° TIV2751 
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Flowchart 11A. 
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Flowchart 11B. Staged I/O Routine (ITVSTG Part 2 of 13) 
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Flowchart 11C. Staged I/O Routine (IIVSTG Part 3 of 13) 
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Flowchart 11D. Staged I/O Routine (IIVSTG Part 4 of 13) 
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Flowchart 11E. Staged I/O Routine (IIVSTG Part 5 of 13) 
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Flowchart 11F. Staged I/O Routine (IIVSTG Part 6 of 13) 
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Flowchart 11G. Staged I/O Routine (TIVSTG Part 7 of 13) 
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Flowchart 11H. Staged I/O Routine (IIVSTG Part 8 of 13) 
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Flowchart 113. Staged I/O Routine (IIVSTG Part 9 of 
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Flowchart 11K. Staged I/O Routine (IIVSTG Part 10 of 13) 
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Flowchart 11L. Read FCB Subroutine (IIVSTG Part 11 of 13) 
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Flowchart 11M. Load FCB Subroutine (TIVSTG Part 12 of 13) 
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Flowchart 11N. EODAD and SYNAD Subroutines (IIVSTG Part 13 of 13) 
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CAW Verification Routine (Flowchart 12A) 


Module name: IIVAWV ) 
Entry point name: IIVAWV 


Major functions: Validates the DOS CAW and initializes the CCW 
pointer in STGCON for modules IIVSTG and IIVLOG 


Entered by: 


e IIVSTG 
e IIVLOG 


Modules called: None 
Exits to: Caller 

OS macros issued: None 
Input: DOSCORE (DOS CAW) 
Output: 


e COMTAB (storage protection key) 
e STGCON (CCW pointer, CSW) 


Return codes: None 

Tables/work areas: 

e STGCON - dummy IOB area 

e DOSCORE - DOS low storage J 
e Local execution list 

e. COMTAB 

Errors detected: 

e Nonzero value in bits 4-7 of DOS CAW 

e Command address not on a doubleword boundary 


e Command address greater than the limit address in local 
execution list 


Messages requested: None 
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Flowchart 


12A. 
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CCW Verification Routine (Flowchart 13A) 


Module name: IIVCWV J 
Entry point name: IIVCWV 

Major functions: 

e Validates and interprets DOS CCWs for modules IIVSTG and IIVLOG 

e Changes pointers from TIC CCWs to TIC-+TO-CCWs 

Entered by: 


e ITIVSTG 
e IIVLOG 


Modules called: None 

Exits to: Caller 

OS macros issued: None 

Input: 

° STGCON: STGFLG (first CCW), STGCCW (CCW pointer) 

e DOS: CCW 

° Local execution list: DRILIMAD (limit address of DOS) 
Output: 

STGCON: STGCCW (CCW pointer), STGCSW (channel status word) 2) 
Return codes: None 

Tables/work areas: 


e STGCON (dummy IOB area) 
e Local execution list 


Errors detected: 

e Nonzero value is contained in bits 37-39 of CCW 
e First CCW (CCW addressed by CAW) is a TIC 

° Count field in CCW is zero 

e TIC/TIC sequence of CCWs was encountered 


e Data address and count greater than the limit address in the 
local execution list 


e Command address in a TIC CCW is greater than the limit 
address in the local execution list 


e Command address in a TIC CCW is not on a doubleword boundary 


Messages requested: None 
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Flowchart 13A. CCW Verification Routine (TIVCWV) 
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Printer Overflow Routine (Flowchart 14A) 


Module name: IIVPOV 
Entry point name: IIVPOV 
Major functions: 


° Maintains the simulated sense byte and status portions of the 
CSW for staged printer devices 


e Simulates the carriage tape operation normally performed by the 
printer during output staging 


Entered by: 

e IIVSTG 

Modules called: None 

Exits to: Caller 

OS macros issued: None 

Input: CCW operation code (STGCCW) 
Outputs: 


e Status portion of CSW 
e Sense byte (STGSEN1) 


Return codes: None 

Tables/work areas: 

e Emulator forms-control image created by IIVSTG 

e STGLNPTR index into Emulator forms-control image created by IIVSTG 
° STGCSW channel status word (STGCON) 

e STGSEN1 sense byte (STGCON) 

e STGLNCNT lines/page (STGCON) 

e STGCHFLG printer carriage tape channel flags (STGCON) 

° STGCTP address of Emulator forms-ccntrol image created bv IIVSTG 
Errors detected: None 


Messages requested: None 


216 DOS Emulator Logic 


Flowchart 114A. 
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Adjust CCW Data Address Routine (Flowcharts 15A~15F) 


Module name: IIVCCW J 
Entry point name: 


e II VCCW 
e RCCWAB4 


Major functions: Adjusts data addresses ina string of CCWs prior to 
their being passed to OS for an I/O operation and 
after completion of the CCW function in OS 


Entered by: 


e ITIVRTE 
e IIVPCE 
e TIVCHK 


Modules called: IIVADJ 


Exits to: 

e IIVPCE 
e ITIVCHK 
e Caller 


OS macros issued: SAVE 
Input: 


Adjustment factor 

Pointer to a CCW string 

Pointer to the local execution list | 
Pointer to the Emulator constants area (IIVCON) 

Pointer to COMTAB 

Local limit address 


Output: Adjusted CCW string 
Return codes: 


e Error code 16 for IIVABN 
e Error code 20 for IIVABN 


Tables/work areas: 


Adjust CCW data address list (located in IIVCON) 

BEBLK CCW addresses for adjusting 

Status modifier table used to find status modifier-type CCWs 
RCCWSAVE register save area 


Errors detected: 


e Adjusted addresses not within DOS storage area 
e BEBLK is filled and CCW adjusting cannot proceed 


Messages requested: None 
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Flowchart 15A. 
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Flowchart 15B. 
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—-------7 
HOKWKAMNHOA 
monowawowvoe 
~~ 


SET COMBINE 
SWITCH OFF 


SET FIRST 
CCW-A-TIC 
SWITCH OFF 


SYMBOL TABLE 


LIST --_ADJUST 
CC ATA 
ADDRESS LIST 


OWOCCTIIO 
b> dWNW—— 


Be 


COMPLETE BIT ON 
IN ALL _BEBLK 
ENTRIES 


MOVE [{NCOMPLETE 
BEBLK ENTRY TO 
CURRENT BEBLK 
ENTRY 


MOVE CCW 
ADDRESS FROM 
BEBLK TO LIST 

Ccw POINTER 


MOVE OPERATION 
BYTE AND 
OPERATION 


POINTER FROM 
BEBLK TO LIST 


ADD 8 TO 
INCOMPLETE 


BEBLK ENTRY 
POINTER 


FROM 
(SA/F5 iy 
(Fs) YES 


RCGy = 


SET CURRENT 
POINTER TO 
BEBLK_ BEGINNING 
ADDRESS +8 


RESTORE 
REGISTERS: TURN 
OFF ABEND 
BYPASS SWITCH 


PUT ACTUAL 
RELOCAT1ON 
FACTOR IN LIST 


RETURN 


READJUST 


LIM 
ADORESS IN L 


MOVE CCW 
ADDRESS FROM 
BEBLK TO LIST 

CCW POINTER 


SET ABEND 
BYPASS SWITCH 


G3 


rs 
a! , ” 


I IVADJ 16A/A2 


YES 
ADJUST CCW DATA 
ADDRESS ROUTINE 


ISSUE ADJUST 
CCW STRING 
INSTRUCTION; 
SET ABEND 
BYPASS SWITCH 


RCCWI7C J3 


RCCWIT7A K3 


LIST 
Ccw POINTER 
< BEBLK AND 
ADDRESS 


NO 


ADD 8 TO 
CURRENT POINTER 


Adjust CCW Data Address Routine (IIVCCW Part 3 of 6) 


FROM STAE 
RETRY 
ROUTINE IN 
| IVRTE 
(CHART 20C) 


SET ERROR 
CODE TO 16 


TO LIVPCE (CHART 
8M) OR ILIVCHK 
{CHART 98) 


K5 


LAST BEBLK NO 
ENTRY 


YES (=) 


Program Organization 


Flowchart 15D. 
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OFF 


Adjust CCW Data Address Routine (IIVCCW Part 4 of 6) 
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Adjust CCW Data Address Routine (TIVCCW Part 5 of 6) 
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Flowchart 15F. 
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CCW Adjustment Routine (Flowcharts 16A-16B) 


Module name: IIVADJ 

Entry point name: IIVADJ 

Major functions: Adjusts CCW data addresses 
Entered by: 


e TIVCCW 
e ITIVRCW 


Modules called: None 

Exits to: Caller 

OS macros issued: None 
Input: 

Adjustement factor 
Pointer to a CCW string 


Pointer to the local execution list 
Local limit address 


Output: Adjusted CCW string 
Return codes: None 
Tables/work areas: 


e Adjust CCW data address list (located in IIVCON) 
e ADJSAVE register save area 


Errors detected: 

e Adjusted addresses not within DOS storage area 
e ccW not on doubleword boundary 

® Invalid CCW address 


Messages requested: None 
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Flowchart 16A. 


ccW Adjustment Routine (IIVADJ Part 1 of 2) 
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OPE 
OP 
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CcW Adjustment Routine (IIVADJ 
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Supervisor Call Routine (Flowchart 17A) 


Module name: TIIVSVC 

Entry point name: IIVSvc 

Major functions: Directs DOS SVCs to proper Emulator modules 
Entered from: 


e DOS when DOS issues a supervisor call 
e IIvSc.l 


Modules called: 


e TIVADD 
e TIVPUB 
e TIVGP2 


Exits to: 


° TIVRTE (normal exit) 
° IIVABN (error exit) 


OS macros issued: None 

Input: DOS registers 

Output: Manipulates PSWs for supervisor calls 
Return codes: xX't04t to TIVABN for termination 
Tables/work areas: 

EMUCONS 

DOS storage 

DOS CCB 


DOS COMREG 
Local execution list 


Errors detected: None 


Messages requested: None 


228 DOS Emulator Logic 


Flowchart 117A. Supervisor Call Routine (TIVSVC) 
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Start I/O, End-of-Extent, Channel End, and Abnormal End Appendage 
(Flowchart 18A-18B) 


Module name: IGG019SA 


Entry point name: 


° IGG019SA 
e SIORTOOO 
e AERTO00 
e CERTO00 


Major functions: 


Maintains (modifies/restores) DEB infcrmation so that DOS I/0 
requests may be done by OS IOoOcs 

Uses the DOS mode set command fcr all tape I/0 

Uses the DOS file mask for all I/O on dedicated DASD volumes 
Inhibits automatic cylinder switching for all DASD I/0 

Makes the user label track associated with a shared volume data 
set accessible to the DOS OPEN/EOF routines 


Entered by: OS input/output supervisor routines 
Modules called: None 
Exits to: Caller 


OS Macros issued: None 


Inputs: 

e Pointer to DEB 
« Pointer to DCB 
e Pointer to UCB 
° Pointer to I0B8 


Output: Modified DEB extent and/or device modifier fields as required 
to support DOS I/O requests 


Return codes: None 
Tables/work areas: COMTAH, DEB 
Errors detected: None 


Messages requested: None 
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Flowchart 18A. Start I/O, End-of-Extent, Channel End, and Abnormal 
mnd Appendage (IGG019SA Part 1 of 2) 
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Flowchart 18B. Start I/O, End-of-Extent, Channel End, and Abnormal 
End Appendage (IGG019SA Part 2 of 2) 
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AbnOrmal EFnd/Channel End Appendage (Flowchart 19A) 


Module name: IGG019S1 

Entry point name: IGG019S1 

Major functions: 

® Flags device 'not ready' condition after rewind-unload has been 
issued 

e Prevents OS error recovery procedures from being loaded for 
incorrect length conditions on tape and unit record devices 

e Prevents OS error recovery procedures from being entered for BTAM 
tintervention required! condition 

e Prevents OS error recovery procedures from being entered for unit 
record ‘unit exception! conditions 

Entered from: OS input/output supervisor interruption handler 

Modules called: None 

Exits to: Caller 


OS macros issued: None 


Tnput: 

e Pointer to DCB 
e Pointer to DEB 
e Pointer to UCB 
e Pointer to IOR 


Output: 

e IOB exception condition bit 
° ECB completion code in IOB 

e UCB interception bit 

e UCB 'not readv' bit 

e COMTAB entry ‘not readyt bit 


Return codes: None 


Tables/work areas: 


e IOB 
e UCB 
e COMTAB 


Errors detected: None 


Messages requested: None 
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Flowchart 19A. Abnormal End/Channel End Appendage (IGG019S1) 
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DATA 
CHAINING, NO 
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BITS ON IN 
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LEAVE! Hi (i) 
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SET ECB CODE 
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SET 108 
EXCEPTION BIT 
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RETURN 
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Asynchronous Interruptions 


C 
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Asynchronous Interrupt Exit Routine (Flowcharts 20A-20G) 


Module name: IYIVRTE 


Entry point names: 


ITVRTE 

ITIVRTER2 
TIVRTETM 
TIVRTEOJT 
IIVRTEST 
ITVRTESR 
TIVRTESY 


Major functions: 


First routine to gain control following asynchronous interruptions 

in local execution mode 

Serves as central routine for all asynchronous interruption handlers 

Serves as central return point for all Emulator routines 

Determines if any interruptions are pending for DOS and gives 

control to the proper routine to process them 

Cheeks for end-of-job conditions 

Issues the STIMER macro, decrements the DOS timer, and simulates 

timer interruptions 

Issues the DOS compatibility instruction (see execute local 

instruction in Appendix) to return to adjusted DOS storage area 

Issues WAIT macro when DOS-requested input/output operations 

are not completed 

Issues STAE macro if a //SYSABEND DD statement is not present, schedules STAE 
retry routine, reissues any STAE retry routine, reissues any canceled WTORs 


Entered from: 


OS supervisor, OS abend processing routines 
TIVINT 
TIVPCE 
ITIVSTG 
TIVLOG 
TIVIN2 
LEVSY¥C 
TIVRAS 
TIVACI 


Modules called: 


TIVPRP 
ITVMSG 
ITVCHK 


Exits to: 


236 


Caller 
DOS 

T TVABN 
JIVLOG 
TIVCC'N 
TIVOPN 
TIVRCW 


DOS Emulator Logic 


OS macroS issved: 


POST 
STAE 
WATT 
STIMER 


Input: =xceot for postasynchronous interruption entries, pointer to 


ITIVCON 
Outvout: 


e Post ECB list entries for IIVPCE 
° Updated DOS timer value 
e Local execution list with contents required by OS 


Return codes: 16 = DOS entered a hard wait 
Tables/work areas: 


Local execution list (located in TIVCON) 

COMTAB 

ECBLIST (dynamic storage) - ECB list to scan 
PENDSN (ITVCON) - interruption pending switch 
BREGSAVE (ITVCON) - register save area 

Post ECB List - index and condition codes of ECs 
BASEREGS (IIVCON) - Emulator hase registers 
DOSCORE - access DOS timer 


found posted 


Errors detected: Detects ABEND condition signified bv DOS hard wait 


PSW 


Messages requested: TIV150T 
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Flowchart 20A. Asynchronous Interrupt and STAE Exit Routines 
(IIVRTE Part 1 of 7) 
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Flowchart 20B. 


1 1VRTER2 

ENTRY FROM LIVPCE (CHART 
BA) 11¥VLOG (CHART 
ioe}, I|IVRTE (CHARTS 
20A ; 20D), IIVSTG 
(CHART 114}, [IVRAS 
(CHART 288), IIVACI 
(CHART 33H), 20C/C4 


CHANNEL 
MASKS ENABLED 


EXTERNAL 
MASK ENABLED 


NO 


R 1) 0 
[IVRTECK 20E/A2 
wTO OR WTOR 
INTERRUPTS ASYNCHRONOUS 
INTERRUPT CHECK 
ROUTINE 


PENDING 


NUMBER 
IN [/0 
PENDING 
COUNTER 
>0 


YES 


SET DRI 
SWITCH ON 


[IVRTESL 20C/At 


SELECT ROUTINE 


FROM 20A/E2 


E3 


1S DOS IN 
WAIT STATE 


NO 


YES 


F3 


DOS SYSTEM 
MASKS 
DISABLED 


NO 


YES 


SET CODE FOR 


ABEND ROUTINE 
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YES 


UPDATE DOS 
BIT 


TIMER BY | 


EXIT 


TO DOS 


Flowchart 20C. Select and STAE Retrv Routines (IIVRTE Part 3 of 7) 
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[INCREMENT TO 
NEXT ECB ENTRY 
TO BE PROCESSED 
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Timer Interrupt Check and Timer Interrupt Subroutines 


(TIVRTE Part 4 of 7) 


TI MECHK 


ENTRY 


FROM SELECT 


ROUT INE 


(CHART 20C) 


SET TIMER 
PENDING SWITCH 
OFF 


SET TIME FOR 
{ SECOND 


GET DOS TIMER 
VALUE 


Ee 


NO 


DOS TIMER >0 


SET TIME 
INDICATOR 
SWITCH ON 


SUBTRACT 1 
SECOND FROM DOS 
TIMER VALUE 


RESTORE DOS 
TIMER VALUE 


| EVRTETM 


FROM OS 


NEW DOS 
TIMER >0 


SET TIME 
See gee ee 


SET DRI 


RETURN SWITCH OFF 


SET TIME 
INDICATOR 
SWITCH OFF 


POST TIMER ECB 


SET PSW 
INTERRUPT 
CODE FOR TIMER 
INTERRUPT 


RETURN 


MOVE DOS 
CURRENT PSW TO 
DOS EXTERNAL 
OLD PSW 


MOVE DOS 
EXTERNAL NEW 
PSW TO DOS 
CURRENT PSW 


VRTER2 


12 IIVRTE AT 
(CHART 20B) 


Program Organization 


241 


Flowchart 20E. Asynchronous Interrupt Check Subroutine (IIVRTE Part 5 of 7) 
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Flowchart 


20F. 


Asynchronous Interrupt Check Subroutine 
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ADD 1 TO NOSIO 
PENDING COUNTER 
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SET DRI 
SWITCH OFF 
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Flowchart 206. End-of-Jok Routine (IIVRTE Part 7 of 7) 


LIVRTEOJ 
ENTRY 
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(CHART 21A) 


ESTABLISH 
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ANY 1/0 
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LOAD ADDRESS OF 
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Fi PIB 


USE _SYSRDR_ PUB 
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SYSRDR DEVICE 
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Prompt Reply Processor Routine (Flowcharts 21A-21E) 


Module name: IIVPRP 
Entry point name: JTIVPRP 


Major functions: Gets control when console operator replies to an 
operator prompt message from the Fmulator 


Entered by: IIVRTE 
Modules called: 
TIVOPN 

TIVMSG 


IITVRAS 
TIVRTEOST 


Exits to: Caller 


OS macros issued: 


e SAVE 

e CLOSE 

e LOAD 

e RETURN 

Input: 

e Pointer to DOS storage area 

e Pointer to TIVCON 

e Pointer to local execution list 

e Reply to previous prompt WTOR 

Output: 

e Prompt for further operator communication 
° Messages to operator dependent on prompt reply being processed 
e Ipdated DOS CSW 

e Updated DOS PSW in local execution list 

e Updated external and I/O PSWs in DOSCORE 


Return codes: None 
Tables/work areas: 


e TIVCON (constants and addresses) 
e LOcal execution list (DOS current PSW) 
e DOSCORE? 

External old PSW 

External new PSW 

I/O old PSW 

I/O new PSW 

PUB 

CSW 

COMTAB 


Errors detected: 
e Replies are checked for a valid Emulator command (FOJ,EXT,ATTN, 


MAPIO, MOUNT, DEBUG) 
e Invalid operands for MOUNT and MAPIO 
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Messages requested: 


IIV1IO1E 
ITVi02E 
IIV103E 
IIVIOUE 
TIV105E 
IIV106E 
TIVIO7E 
IIV1I08E 
TIV1I09E 
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Flowchart 21A. 
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Flowchart 21B. Prompt Reply Processor Routine (IIVPRP Part 2 of 5) 
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QUTPUT AREA 


a’ + r, 


PRPMAP! 21E/A4 


ASSEMBLE WTO 
MESSAGE 


GET DOS PUB 
ADDRESS 


MOVE DOS CUU TO 
OUTPUT AREA 


PRPMAPA 21E/A2 


ASSEMBLE WTO 
MESSAGE 


GET NEXT DOS 
PUB_ ENTRY 
ADDRESS 


END OF DOS 
PUB 


YES 


GET END OF 
OUTPUT AREA 


MOVE ROUTE AND 
DESCRIPTOR 
CODES TO OUTPUT 
AREA 


}iVMSG 2TA/AI 


ISSUES MESSAGE 
LIVIO3E 


Flowchart 21C. Prompt Reply Processor Routine (IIVPRP Part 3 of 5) 


FROM 21A/F3 (es) 


PRP60 ¥ BI PRP65 { B3 


LAST ENTRY 
IN_REPLY 
TABLE 


YES LAST ENTRY 
IN_REPLY 


TABLE 


YES 
CLOSE DCB 


}TVOPN 5A/A2 


OPEN ROUTINE 


GET NEXT REPLY 
TABLE ENTRY 
ADDRESS 


GET NEXT REPLY 
TABLE ENTRY 
ADDRESS 


IIVMSG 2TA/AI 4 


ISSUES MESSAGE 
VI0O4E 


MOVE REPLY TO 
CUU WORK AREA LENGTH >6 


11 


1IVMSG 2TA/AI 
ISSUES MESSAGE 
LIVIO5E 


LAST ENTRY 
IN_REPLY 
TABLE 


YES 


CONVERT CUU TO 


MOVE REPLY TO 
HEXADEC | MAL 


VOLUME SERIAL 
WORK AREA 


PRP62 PRP67 


H3 
CUU IN COMTAB DCB OPEN 
: 


11VMSG 2TA/AI 


ISSUES MESSAGE 
TIVIOTE 


NO 


LIVMSG 27A/AI 


ISSUES MESSAGE 
1IVIQ6E 


GET DCB ADDRESS 
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Flowchart 21D. Prompt Reply Processor Routine 


“LIVMSG 27A/At 


ISSUES MESSAGE 
11V108E 
H3, 
c5 
F3 
F4 
J4 


CLEAR REPLY 
AREA 


SET PROMPT 
PENDING BIT OFF 


GET RETURN 
ADDRESS _IN LINK 
REGISTER 


RETURN 
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(IIVPRP Part 4 of 5) 


: FROM 21A/G3 


B5 


LI¥MSG 2TA/AI 


NO 
ISSUES MESSAGE 
IIViIO7E 


SNAP DD 
CARD PRESENT 


YES 


ISSUE LOAD 
FOR IIVRAS 


IIVRAS 28A/A1 


TRACE AND SNAP 
ROUT INE 


Flowchart 21E. PRPMAPA and PRPMAP1 


FROM |1VPRP 
(CHART 21B) 


GET COMTAB 
ADDRESS AND 
NUMBER OF 
ENTRIES 


PRPMAPB 


DOS CUU 
COMT AB 


IN MOVE NOT IN OS 
PUB INDICATOR 


TO OUTPUT AREA 


PRPMAPC 


MOVE SYSLOG 
INDICATOR TO 
OUTPUT AREA 


MOVE STAGE 
INDICATOR TO 
OUTPUT AREA 


MOVE OS CUU TO 
OUTPUT AREA 


Subroutines 


(IIVPRP Part 5 of 5) 


PRPMAP ae 
FROM |1VPRP 
(CHART 21B} 

B4 


NO 


GET MESSAGE 


SET UP NEW 
LINE ADDRESS AT MESSAGE LINE 


LAST MESSAGE 


GET MESSAGE 
LINE ADDRESS OF 
NEXT MESSAGE 


E4 


[IYMSG 27A/AI1 


ISSUES MESSAGE 
LI1Vtogl 


YES 


MOVE OUTPUT 
AREA TO MESSAGE 
LINE 


RETURN 
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Direct~Access Volume Sharing 


252 DOS Emulator Logic 


SVC Monitor Routine (Flowcharts 22A-22D) 


Module names IIVGR2 
Entry point name: TIIVGR2 
Major functions: 


e Monitors SVC 1, 2, 4, and 11 calls from DOS 


° Tnhibits DOS execution of library maintenance programs when DOS system 


residence volume is a shared volume 


Recognizes volume-shared files or OS indexed sequential shared data sets 


Calls TIVDVS or TIVIS to verform the needed functions 
Entered by: TIvsvc 


Modules called: 


e IIVIS 
e ITIVMSG 
e ITVDVS 


Fxits to: Caller 
OS macros issued: RETURN 
Tnput: 


° Register 9 must contain a pointer to the local execution list. 
e Register 10 must contain a pointer to DOS storage, 
e Register 11 must contain a pointer to IIVCON. 


Output: None 
Return codes: Contained in register 15 
Tables/work areas: 


Local execution list 
IIVCON 

DLBL 

DTF 

FID 

COMTAB 

COMTAB extension 


Errors detected: 


Invalid logical unit 

Unit unassigned or assigned in error 
Invalid physical unit 

No DD card or invalid DLBL 


Messages requested: 


TIV208T 
TIV2501 
IIV2511 
TIV252T 
TIV2531 
TIV254T 
TIV2551 


@eetee8 8 6 
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DOS SVC Tables. Figure 25 shows the DOS SVC tables. Whenever DOS issues an 

svc 2, the Emulator traps the SVC and determines which routine in TIVGR2 gains 

control from SVC2TAB or SVC2PP. The factors that affect which routine in 

IIVGR2 gains control are the caller that issues the SVC 2 and the B-transient ) 
phase called. 


The SVC11TAB lists the B-transients that issue an SVC 11. The Emulator traps 
this svc to determine which phase issued the SVC so control can be passed to 
routine GR2CLS in IIVGR2. 


The SVC4TAB shows which Bertransient phase issues an SVC 4 and the phase it 
calls. The Emulator traps this Svc 4 and gives control to GR2EOJ in IIVGR2. 


SVC2TAB (when SVC 2 is issued) 


CALLER CALLED ROUTINE IN TIVGR2 
$$BOSD0 1 $$BOSDO1 TSTOPN 22B/3B2 
$$BOSDO7 GR2EOX 22C/B1 
SSBOSDI1 TSTOPN 22B/B2 
$SBOSDW1 GR2OPN 22B/B1 
$ $BOSDW3 GR2 EOX 22C/B1 
$$BOSDO4 $$BOSDO6 GR2EOX 22C/B1 
$$ BOSDO6 $S$BCLOSE GR2CLS 22C/B2 
$$BOSD09 $$BOSD06 GR2EOX 22C/B1 
$$BOSDT1 $$BOSDI3 GR2EOX 22C/B1 
$$ BOSDI3 $ $BCLOSE GR2CLS 22C/B2 
$SBOSDI4 $$BOSDI3 GR2EOX 22C/B1 
$$BOSDW2 $SBOSDW1 GR2EOX 22C/B1 
$$BOPEN2 $SBODAIN GR2O0PN 22B/B1 
$SBOISO1 GR2OPN 228/B1 
$$BORTV1 GR2OPN 22B/B1 
$ $BODAIN $S$BODAO 1 GR2EOX 22C/B1 
$$BODAT1 GR2EOX 22C/B1 
$ $BODAT 1 $SBODAU1 GR2EOX 22C/B1 
$S$BOFLPT $$BOSDW1 GR2EOX 22C/B1 
$SBODAU1 GR2EOX 22C/B1 
$ $BOPEN $SBOPEND RMSRES ET 22D/B4 
SSBCLOSE $$BODACL GR2CLS 22C/B2 
S$$BOSDC1 GR2CLS 22C/B2 
$SBCISOA GR2CLS 22C/B2 
$$BOPEND GR2CLS 22C/B2 
$$BOSDC1 $$BOSDO1 GR2 EOX 22C/B1 
$$BOSDW3 GR2 EOX 22C/B1 
$SBCLOSE GR2CLS 22C/B2 
$$ BOSDO6 GR2 EOX 22C/B1 
SS$BOSDI3 22C/B1 


Figure 25 (Part 1 of 2). 
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GR2EOX 


DOS svc Tables 


SVC2TAB (when SVC 2 is issued) (continued) 


ROUTINE IN IIVGR2 CHART 


$$BOSDC2 $$BCLOSE GR2CLS 22C/B2 


$ $BOMSG2 SSBODSPV GR2DPV 22D/B5 
$ $BOVDMP GR2DPV 22D/B5 
$$BODSPV GR2DPV 22D/B5 


$ SBOSDMW $S$BOVDMP GR2DPV 22D/B5 


SVC2PP (when SVC 2 issued for SETFL, ENDFL, or SETL) 


Problem $$BSETFL ISSETFL 22D/B1 
program $S$BENDFL ISENDFL 22D/B2 
$$ BSETL ISSETL 22D/B3 


SVC11TAB (when SVC 11 is issued) 

ROUTINE IN ILIIVGR2 
$$BOSDC1 GR2CLS 22C/B2 
$S$BOSDC2 GR2CLS 22C/B2 
$$BOSDI3 GR2CLS 22C/B2 


| $$BOSD06 GR2CLS 22C/B2 


SVC4TAB (When SVC 4 is issued) 


ROUTINE IN IIVGR2 


GR2 EOJ 


CALLER CALLED 


$SBEOI SJOBCTLA 


Figure 25 (Part 2 of 2). DOS SVC Tables 


CHART 


22C/B3 
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Flowchart 22A. 


ENTRY 


FROM |LIVSVC 
(CHART 17TA) 


STANDARD 


LINKAGE FROM 
IIVvsvce 
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GET DOS PHASE 
NAME AND LOCK 
PHASE NAME 
TABLE ADDRESS 


GR200012 


DOS PHASE = 
TABLE PHASE 


YES 


YES 
END OF TABLE 


GET NEXT TABLE 
ENTRY ADDRESS 


GET NAME OF 
PHASE FROM DOS 
REGISTER 1 


SVC4TAB * 


LOCATE CALLER 
AND CALLED-IN 
TABLE 


DOS Emulator Logic 


GR200050 


SVCIITAB® 


LOCATE CALLER * 
AND CALLED-IN 5 
TABLE SV 

SV 

(F 


SVC Monitor Routine (IIVGR2 Part 1 of 4) 


* SEE SVC2PP 
(FIGURE 25) 


B4 


YES 
B4 


ISSUED BY 


A NO 
B-TRANS 1 ENT 


YES 


RESET SWITCH 


°OK FOR ACCESS 
ON vToc' 


D3 


D4 


YES PHASE 
CALLING 


ITSELF 


NO 


NO 


MOVE NXTBTR 
INTO 


OLDBTR;MOVE NEW 
PHASE INTO 
NXTBTR 


F4 


YES CALL FOR 


$$BOmMSGI 


SVC2TAB*® 


LOCATE CALLER 
AND CALLED-IN 
TABLE 


MOVE NXTBTR 
INTO OLOBTR3; 


MOVE PRPGM IN 
NXTBTR 


YES 


NO 


YES 


NNNNN NPT 
NNNNANNANNNNPT 
ialolezelelel ih up ale) 
OWN=-OWOs———o 


CLEAR RESTORE 
CODE 


STAN 


DARD 
LINKAGE BACK TO 
}IVSVC 


RETURN 


GR200016 


SET # IN LAST 
CHARACTER OF 
DOS PHASE NAME 


I1VMSG 2TA/AI 


ISSUES MESSAGE 
Ve 


i=) 
& 


ALLOW 
LINK-EDIT 


Flowchart 22B. SVC Monitor Routine (IIVGR2 


228 
Be 


FROM 22A/G4 
FROM 22A/G4 


TSTOPN Be 


TAKE DTF 
ADDRESS FROM 
DOS REGISTER 2 


NO YES 


1S DTF OPENED 


TAKE DLBL 
ADDRESS FROM 
DOS OPEN TABLE 


FROM 22D/B5 


DI 


NO |S LOGICAL 


UNIT IN DLBL 


SAVE _LTK AND 


POINT TO NICL 


YES 


E3 


MOVE LOGICAL 
UNIT IN DTF 


VALID NO 
LOGICAL UNIT 


YES 


POINT TO 


CURRENT LUB 


LUB 
UNASSIGNED 


POINT _TO 


CURRENT PUB 


K3 


YES NO 


Part 2 of 34) 


B5 


COMTAB NO 
ENTRY FOUND 


YES 


OPNOO800 cs 


DEDICATED 
VOLUME 


NO 


D5 


YES 
DISPLAY VTOC 


NO 


ANALYZE CTEXT 


CHAIN FROM 
COMT AB 


FOUND 
MATCHING DSN 


FILE FORMAT 
COMPATIBLE 
QOS-DOS 


YES 


SET DTF, LTK, 


AND CTtEXT 


POINTERS [IN 
PARAMETER LIST 


O 
OPEN FOR ISAM 


LIVIS 24A/Al 


PROCESS OPEN 
FUNCT ION 


[IIVDVS 23A/Alt 
PROCESS OPEN 
FUNCT !ON 
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Flowchart 22C. SVC 


FROM 22A/F4, 
22A/G4, 
22B/B2 


SET CODE IN 
PARAMETER LIST 


SET CODE IN 
PARAMETER LIST 
FOR CLOSE 


FOR END OF 
EXTENT 


DOS KEY OUT OF 
COMREG:; DTF OUT 
OF DOS REGISTER 


TAKE FID CHAIN 
FOR NON-ISAM OR 
1SAM 


SET CODE, DIF, 
AND FID IN 
PARAMETER LIST 
FOR CLOSE 


1LIVDVS 23A/A1 


OR IIVIS 24A/Al 
PERFORM CLOSE 
FUNCTION 


OTHER FID 
IN CHAIN 


1S_$$BOMSG! 
CALLED 


DIRECT-ACCESS/ 
SEQUENTIAL DASD 
SHARED VOLUMES 
SUPPORTED 


YES 


SET CODE FOR 
OPEN _ IN 
PARAMETER LIST 
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Monitor Routine 


(TIVGR2 Part 3 of 4) 


FROM 
22eB/Je, 
22B/E4, 
22B/Fe, 
FROM FROM 22B/K4, 22B/Ge, 
22A/G4 22B/K5 22eB/F4, 
22B/G4 


GR290000 B4 


POINT TO FID 
CHAIN FOR 
VOLUME SHARING 


NO ALIZE FOR 


ZERO RETURN 
CODE NG MESSAGE 


YES FROM 
22D/D5 


C4 


YES 
ISSUES MESSAGE 
TO OPERATOR 


MOVE NXTBTR_IN 
PLACE OF BTR 
NAME 


CHANGE SVC_IN 


LOCAL EXECUTION 
LIST TO SVC6 


MOVE PRPGM 
NXTBTR 


INTO 


TAKE NEXT FID 
IN CHAIN 


SET DTF ADD AND 
FID ADD IN 
PARAMETER LIST 


IIVIS 24A/Al 


PERFORM CLOSE 
FUNCTION 


IIVDVS 23A/Al 


PERFORM END_OF 
EXTENT, CLOSE 


OR 
MESSAGE FUNCT 


lon 


Flowchart 22D. 


FROM 22A/G4 FROM 22A/G4 FROM 22A/G4 


> ele - = 


SCANFID 22D/E4 SCANFID 22D/E4 SCANFID 22D/E4 


IDENTIFY OTF IN IDENTIFY OTF IN 
ISAM FID CHAIN ISAM FID CHAIN 


IDENTIFY OTF IN 
ISAM FID CHAIN 


YES YES YES 


SET CODE FOR SET CODE FOR pane Tea ee 


ETL 
PARAMETER LIST 


SETFL_ IN ENOFL 


IN 
PARAMETER LIST PARAMETER LIST 


| M A 


IIVIS 24A/Al 


PERFORM SETFL, 
ENDFL, OR SETL 
FUNCTION 


INDICATE BYPASS 
OF SVC 


INTERRUPT 
SIMULATION 


RETURN 


SET_RETURN FOR 
FID FOUNO 


SVC Monitor Routine (IIVGR2 Part 4 of 4) 


22D 
B4 


FROM 22A/G4 


SET_INDICATOR 
FOR DISPLAY 
VTOC;POINT TO 
OPEN CCB 


BYPASS OPEND IF 


REQUIRED 


GR2DPV 1 D5 


1S $$BODSPV 
CALLEO 


IF $$BODSMW 
CALLING, SET RETURN 
To $$BosMwW; 
OTHERWISE SET 
RETURN TO $$BOSMGI 


FROM 
220/B1, 
22D/B2, 
22D/B3 


GET LTK OF 
PARTITION FROM 
PSW 


SET INDICATOR 
TO ‘OK FOR 
ACCESS ON VTOC' 


MOVE NXTBTR IN 
PLACE OF 
B-TRANSIENT NAME; 
INITIALIZE MESSAGE 
I1V2551 


MATCH LTK 
AND DTF NAME 


INT TO NEXT 
D IN CHAIN 


PO 
FI 
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Device Sharing Simulation Routines (Flowcharts 23A-23H) 


Module name: TIVDVS ) 
Entry point name: IIVDVS 
Major functions: 


e Moves the actual limits of the current extent allocated by OS into 
the DLBL/EXTENT card image 

e Creates (in the obtain routine) VOL1 (volume 1) identifier (format 
1), and extension (format 3) DSCB images to be used by module IIVVIO 

e Controls the flow of DOS B-transient phases to be executed for open, 
end-of-extent, and close operations 


Entered from: IIVGR2 
Modules called: 


e IIVGET 
© IIVMSG 


Exits to: TIIVGR2 


OS macros issued: 


Input: ) 


e DTF address, LTK, COMTAB extension pointer (at open time) or FID 
pointer {at end of extent or close), and PARMCODE in the PARMLST 
field of EMUCONS. 

e COMTAB extension with dsname, ddname, and DCB pointer (at end of 
extent or close). 

e FID with forward and backward pointers, COMTAB extension pointer, 
DTF name, and DOS LTK (at end of extent or close). 

e OLDBTR and NXTBTR fields in EMUCONS. 

e Register 10 points to DOS storage. 

e Register 11 points to EMUCONS. 

e Register 14 contains the return address. 

e Register 15 points to module IIVDVS. 


Outputs 

° Register 15 contains return code. 

e NXTBTR field in EMUCONS contains next B-transient phase to be executed. 
® FID created (at open time) or suppressed (at close). 

@ 


COMTAB extension updated with DCB pointer and use count (at open and close). 
Return codes: 
e 0 = gives control to next B-transient phase pointed to by the 


NXTBTR field in EMUCONS. 
° # 0 = cancels DOS partition. 
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Tables/work areas: 


COMTAB extension 

FID 

DTF 

DLBL 

Open table 

DOS communication regton 
EMUCONS 


Errors detected: 


Open failure For a data set 

DCB and DTF device tvpes incompatible 

Insufficient extent space in DOS DLBL/EXTENT image for DTF 
User labels specified in DTF but not in DSCB 

Cannot get more extents for file 

Cannot obtain identifier (format 1) DSCB for a data set 
Point outside extents cf a data set 


Messages requeste34: 


TIV2561 
TIV2571I 
TIV258T 
TIV259T1 
TIV2601 
TIV261T 
TIV262T 
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Flowchart 23A. 


262 


ENTRY 


FROM IIVGR2 
(CHARTS 
22B AND 22C) 


1S NEXT NO 


PHASE 
$$BOMSGI 


SET STANDARD 


LINKAGE WITH 
MODULE I1IVGR2 


YES 


SET ADDRESS OF BUILD A DUMMY 
OBTAIN AREA IN VOL1 LABEL_IN 
EMUCONS OBTAIN AREA 


PLACE 
DLBL/EXTENT 
ADDRESS _IN 

REGISTER 


SET SWITCH "OK 
FOR ACCESS ON 
VTOC* 


PLACE DTF 
ADDRESS IN 
REGISTER 


Fi 


1S PARMCODE 
OPEN 


YES (ee 


NO 


PLACE COMTAB 


REGISTER 


Jt 


NO 


1S PARMCODE 
EOXx 


YES 


DOS Emulator Logic 


PLACE COMTAB 
EXTENSION 


ADDRESS _IN 
REGISTER 


I I¥VGET TA/A3 


ISSUE GETMAIN 
FOR A FID 


ATTACH FID TO 
EXISTING CHAIN 


MOVE DTF FIL 
NAME AND DOS 
LTK INTO FID 


E 


MOVE COMTAB 
EXTENSION 
POINTER_ INTO 
Fic 


INCREMENT USE 
COUNT IN COMTAB 
EXTENSION 


YES 


11VGET TA/A3 


[ISSUE GETMAIN 
FOR A DCB 


STORE DCB 
ADDRESS _IN 
COMTAB 
EXTENSION 


INITIALIZE DCB 
FROM DADCB IN 
EMUCONS 


Nevice Sharing Simulation Routine (TIVDVS Part 1 of 8) 


SET DCB FDAD ON 
LAST TRACK ON 
LAST EXTENT 


ZERO TRACK 
BALANCE IN DCB 


CHECK OS AND 
DOS DEVICE 
TYPES 


E5 


SAME DEVICE 
TYPE 


NO 


Flowchart 


23B. Device Sharing Simulation Routine (IIVDVS Part 2 of 8) 


23B 
B! 


FROM 23A/E5, 
23A/lF5 


GET DEB ADDRESS 
OM DC 


FR 


B 


ci 
OPENG 
NO TURN OFF ‘LAST 
DOS DTFDA EXTENT® IN 


EXTENT 


MOVE LOGICAL 
UNIT OF FIRST 


DLBL/EXTENT 


SET DOS 
REGISTER_6 TO 
POINT TO 
DLBL /EXTENT 


IN DTFDA 


RESET 
BIT 


‘NEW VOL‘ 


INPUT 
DOS WORKF ILE SEQUENT | AL IN DTF 


MOVE $$BOSDWe 
IN NXTBTR 


SET VOLUME 
SEQUENCE NUMBER 
IN DTF 


TURN ON 
*DELETFL=NO,° 
*SYS IN DTF,* 
"EXTENT OPEN® 


SET SYSLNK OPEN 
BIT_IN OPEN 
TABLE 


DOS DTFPH 


RESET COBOL 
IGNORE 


RESET LIOCS 
SWITCHES IN DTF 


OPEN4B 


TURN_ON ‘LAST 
EXTENT’ IN 
DLBL/EXTENT 


ONLY 1 
EXTENT IN DEB 


POINT TO FIRST 


EXTENT IN DEB 
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PUT VOLUME 
SEQUENCE AND 


EXTENT SEQUENCE 
IN DTF 


NO 


FS 


YES 


RESET OPEN BIT 
IN DTF 
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Flowchart 23C. Device Sharing Simulation Routine (IIVDVS Part 3 of 9) 


FROM 23A/JI (3 ) 


EOXx EQX10 B3 EOX20 B4 EQX2 1 B5 


IS $$BOSDWS3 
CALLED 


IS $$50SDWI 
CALLED 


SET DCBREG AND IS NO NO 


$$B0SDI1 
ALLED 


DEBREG 


Cc 


YES 


oa| c3 


TURN ON 
*DELETFL=NO’ IN 
DTF 


AFTER A DOS 
POINT MACRO 


YES 1S §$BOMSG! END-OF-FILE YES 
CALLED STATE 


NO 


DI EOX20A D5 


MORE YES 
EXTENTS 


AVAILABLE 


C4) YES 


NO E3 E4 


PICK 


IS $$BODAU! 
CALLED CORRESPOND ING 
EXTENT IN DEB 


MOVE $$BOSDWe 
IN NXTBTR 


1S $$BOSD06 YES YES YES 


CALLED 


EXTENT 
FROM $$BOSD04 FOUND IN DEB 


YES NO 


MOVE USER LABEL RESET LIOCS 


[IS $$BOSDI3 
CALLED TRACK _ADDRESS SWITCHES IN DTF 
IN DTFSD 


MOVE DATA TRACK 


DIRECT-ACCESS ADDRESS_IN 
FILE 


DTFSD 


EOXOA H2 H3 


ADD {_TO NUMBER OF 

RELATIVE RELATIVE TRACKS3$ 
TRACK ADDRESS SUBTRACK | FROM 
SPECIFIED BEGINNING ADDRESS 
IN FIRST EXTENT 


NO USER LABEL 


SPECIFIED IN 
DTFDA 


IS §$B80DAI1 
CALLED 


IN 
0 


MOVE $$BODAU! 
IN NXTBTR 


MOVE ‘DAUI' 
DOS REGISTER 


FUNCTION IS 
‘OBTAIN ONLY’ 


MOVE ZERO IN YES 


MOVE $$BOPEN IN 
NXTBTR DOS REGISTER 0 
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Flowchart 23D. 


ROM 23C/B5 
FROM 
23C/F3, 
23C/E3 


Bl EOX30C 


EOX30 


NO MORE STORE DLBL 
EXTENTS ADDRESS_IN DOS 
AVAILABLE REGISTER 6 


YES 
cl 
NO TAKE EXTENT 
EOV FORCED SEQUENCE NUMBER 
FROM DTF 
FROM 23C/C4, 
23C/E5 
EOXx r 

ADD {1 TO EXTENT 

SEQUENCE NUMBER 
NO 


STORE EXTENT 
SEQUENCE NUMBER 
IN DTFSD 
(OUTPUT) 


Device Sharing Simulation Routine (IIVDVS Part 4 of 8) 


EOX3If B3 B4 


IS EXTENT YES NO 
IN DEB 


NO 


C3 


NO TURN_ON ‘LAST 
EXTENT® IN DLBL 


EOX33 


CAN EOV BE 
ISSUED 


SET DEBREG ON 
CURRENT EXTENT 
IN DEB 


EOV FOR 
SECONDARY 
ALLOCATION 


UPDATE NEW 
TRKBAL AND FDAD 
IN DCB 


DID EOV 
GIVE MORE 
EXTENTS 
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Flowchart 23EF. Device 
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23A/ JI 


CALLED BY 
$$BCLOSE 


Di 
CLOSEe2 


FROM $$BOSD06 : 
FROM $$BOSDI3 


Sharing Simulation Poutine (TIVDVS Part 5 of 8) 


CLOSEO 


DECREMENT USE 


COUNT _IN COMTAB 
EXTENS | ON 


C3 CLOSE | 


GET DCB ADDRESS 
FROM COMTAB 
EXTENSION 


3 


FROM 23A/J5 


() A : 
IL IVGET TA/A3 


FREE SPACE OF 
DCB 


DOS Emulator Logic 


Flowchart 23F. 


NNNMNMNP 
WWWWWWW7) 
ilulelelelelels) 
~ 
AQVUAAMC 
WNPUS b— 


SET SWITCH ‘OK 


FOR ACCESS ON 
VTOC° 


on 


SAME DATA 
SET ne IN 


NO 


NO WAS OPEN OR 


EOV ISSUED 


BUILD A VOL! 
IMAGE_IN 
| | VOBE1 


NO 
OBTAIN Fi 
HI 
YES 
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NO 


MOVE Fi ADDRESS 


IN VOL(t IMAGE 


MOVE Fi COUNT 
FIELD IN 
| | VOBE 1 


OBTNO4 D2 


MORE DSCB’S 


OBTAIN NEXT 
DSCB 


OBTNOS5 G2 


USER LABEL 
ROUTINE IN 
DTF 


I IVMSG 2TA/AI 


ISSUES MESSAGE 
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OBTAINO B4 


PREVIOUS 
ERROR 


YES 


NO 


OBTAIN! C4 


DOS DIRECT YES 
ACCESS 


NO 


OBTAIN2 D4 


MOVE DISK YES 
ADDRESS OF VTOC DOS WORK FILE 
IN DTFSD 


NO 


OBTAIN3 E4 


SEQUENT IAL 
DISK INPUT 


NO 


YES 


ANALYZE EXTENT 
TYPE IN Ft UNIT_IN OPEN 
TABLE 


MOVE LOGICAL 


H3 


ANY USER 
LABEL EXTENT 
FOUND 


MOVE BIN NUMBER 
IN OPEN TABLE 
AND DTF 


MOVE FIDSCB 
DISK ADDRESS_IN 
OPEN TABLE SEEK 

BUCKET 


SET USER LABEL 
TRACK ADDRESS 
IN ILIVOBE! 


MOVE FIDSCB 
DISK ADDRESS_IN 


OPEN TABLE VTOC 
LIMITS 


Device Sharing Simulation Routine (IIVDVS Part 6 of 8) 


TIYMSG 2TA/AI 


ISSUES MESSAGE 


11V2611 OR 
IIV2591 


D5 


DTFPH 


MOUNTED = ALL 


NO 


MOVE USER LABEL 
TRACK ADDRESS 
IN DTFDA 


MOVE LOGICAL 
UNIT AND BIN 
NUMBER IN DTF 
AND OPEN TABLE 


MOVE FIDSCB 
DISK ADDRESS_IN 
OPEN TABLE SEEK 
BUCKET AND VTOC 

LIMITS 


H5 
NO 
SPECIAL OPEN 


RESET SPECIAL 


OPEN BIT 
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Flowchart 23G. Device Sharing Simulation Routine (IIVDVS Part 7 of 8) 


23F /K5 FROM 23F/K5 


MOVE LOGICAL 
UNIT AND BIN 
NUMBER _ IN DTF 
AND OPEN TABLE 


MOVE LOGICAL 


UNIT_IN OPEN USER LABELS 
ABLE 


MOVE FIDSCB 
DISK ADDRESS_IN 
OPEN_TABLE SEEK 
BUCKET AND VTOC 

LIMITS 


TURN OFF _ LAST 
EXTENT BIT 


PUT USER LABEL 
ADDRESS IN DTF 


MOVE BIN NUMBER 
IN OPEN TABLE 
AND DTF 


De 
MOVE FIDSCB 
DISK ADDRESS_IN 
OPEN TABLE SEEK 
BUCKET 
ES 


NO 
SPECIAL OPEN 
Y 
E2 
NO 


RESET SPECIAL 


MOVE FIDSCB 
DISK ADDRESS_IN 
OPEN TABLE VTOC 
LIMITS 


MOVE FILE _ID IN 


OPEN TABLE 


OPEN BIT 


OBTAIN4SA ¥ G2 OBTAIN4SB _ G3 
YES DOS RELEASE NO 
27 
; MOVE DEVICE TYPE 
CONTROL FACTOR IN 
DOS REGISTER 0 
$$B0SO9 TO NXTBtTR 
MOVE $$80SD05 
IN NXTBTR SPECIAL OPEN 


NO 


MOVE SEEK 
BUCKET TO DTF 


PUT VOLUME 
SEQUENCE NUMBER 
IN DTF 
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Flowchart 23H. 


rrr pf foror 
WWWWWWWWD 
ONOOHO NMG 
oOnNnooomoo 
NS dW UUW 


DLBL Bt 


SPLIT 
CYLINDER IN 
DEB 


NO 


INDICATE SPLIT 
CYLINDER TYPE 


RESET VARIOUS 
BL 


DL 
INDICATORS * 


Et 


NO 
DIRECT-ACCESS 
FILE 


YES 


GET LENGTH_OF 
LABEL AREA FROM 
DOS COMREG 


GI 


YES 


COMPUTE MAXIMUM 
DLBL LENGTH 


TURN ON EXTENT 
CONVERTED _IN 
DIRECT-ACCESS 

BYTE 


SET VOLSER_AND 
FILE-SER FROM 
VOLI IMAGE 


SET DUMMY 
CREATION AND 
EXPIRATION 
DATES 


SET LOGICAL 
UNIT FROM DTF 


SET EXTENT TYPE 
AND SEQUENCE 
NUMBER 


SET EXTENT 
LOWER AND UPPER 
LIMITS FROM DEB 


Ke 


DIRECT-ACCESS 
FILE 


YES 


YES 


ADD {| TO EXTENT 
SEQUENCE NUMBER 


COMPUTE ADDRESS 


OF NEXT EXTENT 
IN DLBL 


G3 


SPACE FOR 
NEW EXTENT 


NO 


IIVMSG 27A/At 


ISSUES MESSAGE 
L1V¥258l 


* 


[I1VGET TA/A3 


FREE SPACE OF 
CURRENT FID 


Device Sharing Simulation Routine (IIVDVS Part 8 of 8) 


FROM 
23E/C3, 
23E/E4 


UPDATE NEXT AND 
PREVIOUS FID 
BLOCKS IN CHAIN 


23 
23 
23 


OWDOMANLTONIOHO 
——-USNWNS WW 


nnn 
WWWWW 


SET RETURN CODE 


RESTORE 
REGISTERS 

STANDARD 
LINKAGE 


RETURN 


NEXT EXTENT ON NEW PACK 
BYPASS 

NEW VOLUME 

NO EXTENT CARD 

EXTENTS OMITTED 
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ISAM Mapping Routine (Flowcharts 24A-24L) 


Module name: JIVIS 
Entry point names: 


e IIVIS 
° IIVISO1 


Major function: To map requested DOS ISAM I/O macro instructions to 
enable accessing OS indexed sequential data sets. 


Entered from: 


e TIVGR2 
° By Specifying entry point in ATTACH macro instruction in IIVIS 
open mapping routine 


Modules called: TIVGET 
Exits to: 


° Caller 
° By issuing DETACH macro instruction in IIVIS close mapping routine 


OS macros issued: 


OPEN 
OPEN TYPE=J 
CLOSE 
SETL 
RDJFCB 
ATTACH 
DETACH 
IDENTIFY 
CHAP 
ESETL 
GET 

PUT 

PUTX 
READ KY 
WRITE 
CHECK 
SAVE 
RETURN 
WAIT 
DCBD 
POST 

DCB 
WRITE K 
WRITE KN 


° Pointer to DOS low storage (DOSCORE) 

e Pointer to EMUCONS (DSECT for IIVCON) 

® Parameter list in EMUCONS (ISAMCODE, ISAMDTFA, ISAMFDCX) 

° Pointer to local execution list 

e Return acdress 

e Register 1 foints to ISBLK (obtained by IIVIS open mapping routine) 
which contains base registers in register save area section. 

° When removed from wait state by POST macro instruction issued by 
SIO routine (module ITVPCE), ISBLK control information contains 
I/O macro code, address of DTFIS table, and address of COMTAB 
entry 


270 DOS Emulator Logic 


Output: 


ISBLK and OPEN DCB 
Error code 


Return codes: 
e 0 in register 15 - switch Svc PSWs 
Tables/work areas: 


COMTAB extension 
FIDBLK 

EMUCONS 

ISBLK 

DOS DTFIS 

DCB 


Errors detected: OPEN macro instruction failure 


Messages requested: None 
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Logical records to DOS problem program from OS indexed sequential data set 
Logical records to OS indexed sequential data set from DOS problem program 
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Flowchart 24A. Main Task Control Executive Routine (IIVIS Part 1 of 11) 
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ENTRY 


FROM 11VGR2@ (CHARTS 
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SAVE CALLER'S 


REGISTERS 


LOAD FIDBLK 
DIFIS TABLE 
ADDRESSES 


DI! 

YES 24B 

OPEN REQUEST Bt 
NO 


LOAD 1SBLK 
ADDRESS 


Fi 
YES My 
NO 
Gt 
YES | 24D 
Bt 
NO 
FROM 
e4L/G5, 
24B/K4, 
XR 7 24B/C2 


24C/K3- 
RETURN 
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Flowchart 24B. 


24B 
Bi 


FROM 24A/DI1 


SET $$BO0PEN AS 
NEXT 


B-TRANSIENT TO 
BE CALLED 


on 


YES 
DATA SET OPEN 


FROM NO 
24B | 24C/K3 


DI 


OPENOOO D 


IIVGET TA/A3 


GET AREA FOR 
| SBLK 


ITIALIZE 
ST DCB IN 
ISBLK 


IN 
FIR 


OPENOO2 Fl 


SECOND DCB 
REQUIRED 


YES 


INITIALIZE 
SECOND DCB IN 
| SBLK 


INITIALIZE 
FIDBLK AND 
COMTAB 
EXTENSION; ADD 
ISBLK TO CHAIN 


Open Mapping Routine 


ISSUE RDJFCB 
MACRO 


C2 C3 


OPEN FOR 
SAME DTF 


NO DTFIS FOR 
LOAD 


YES 


YES NO 


ISSUE OPEN 
MACRO FOR 
DCB(S) 


E3 


YES 
OPEN ERROR 


NO 


F3 


ADDING NO 
RECORDS 


SUPPORTED 


IIVGET TA/A3 


GET WORK AREA 
FOR ADD 


MAP DATA SET 
INFORMATION 
FROM DCB TO 

DTFIS 


SET TRAP CODE 
IN_DTFIS AND 


SET _1ISMOD 
POINTER TO MODE 


OPENATCH K3 


CHAP 
AND IDEN- 
TIFY MACROS 
ISSUED 


(IIVIS Part 2 of 11) 


LOADOO A4 


DLBL OPEN 
CODE CREATE 


NO 


MAP JFCB DCB 
INFORMATION TO 
DCB 


MAP DTFIS 
INFORMATION TO 
DCB 


LOAD D 
OPEN DCB 
E4 
YES 
OPEN ERROR 
NO 


SET TRAP CODE 
IN DTFIS AND 
SET I SMOD 


POINTER TO CODE 


MAP DATA SET 
INFORMAT ION 
FROM DCB TO 

DTFIS 


ISSUE CHAP AND 
IDENTIFY MACROS 
AND SET 
INDICATOR 


THE SUBTASK IS 
ATTACH A ACTIVATED (CHART 
SUBTASK FOR e4E) AND EXECUTE 
DATA SET [1/0 PARALLEL WITH TH 
HANDLING EMULATOR TASK 
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Flowchart 24C. Close Mapping Routine (TIVIS Part 3 of 11) 


XS 


FROM 24B/C2, 
24A/F | 


TERMINATE 


SUBTASK 


c3 


WORK AREA 
FOR ADD 
PRESENT 


NO 


D 
TIVGET TA/A3 


RELEASE WORK 
AREA 
CLOSEQ 
CLOSE DCB(S) 
F3 
<S 


$$BCLOSE TO 
NEXT BTRAN 


REMOVE ISBLK 
FROM ISBLK 


CHAIN; 
DECREMENT CTEXT 
USE COUNT 


1LI1VGET TA/A3 


RELEASE ISBLK 
AREA 


K3 


ENTERED 
FROM OPEN 


YES 
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Flowchart 24D. 


24D 
Bi 


FROM 24A/GI 


SETLRTN B| 


QISAM SCAN 
SUPPORTED 


YES 


Ci 


TWO DCBS USED 


UPDATE LAST 
PRIME RECORD 
ADDRESS 


El 


OS SETL 
OUTSTANDING 


Gt 


DOS SETL 
SPECIFY BOF 


NO 


H1 


DOS SETL 
SPECIFY KEY 


NO 


Jt 


DOS SETL 
SPECIFY GKEY 


NO 


NO 


NO 


NO 


ES 


ES 


ES 


DC 
FOR 


FOR 


DCB OP 
FOR KEY TYPE 
SET 


DCB OPEN 


ISSUE OS_ SETL 
TYPE=B 


B OPEN 
KEY TYPE 
SETL 


Je 


EN 
L 


K2 


ID TYPE 
SETL 


NO 


NO 


CLOSOPEN 24L/Ge 


GET DCB OPEN 
FOR SETL TYPE=K 


CLOSOPEN 24L/Ge 


GET DCB OPEN 
FOR SETL TYPE=K 


CLOSOPEN 24L/G2 


GET DCB OPEN 
FOR SETL TYPE=I 


SETL Mapping Routine (IIVIS Part 4 of 11) 


SET SETL BIT 
IN ISBLK 
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Flowchart 24E. Subtask Control Executive Routine (TIVIS Part 5 of 11) 


SUBTASK IS ENTERED 
FROM OS WHEN 
ATTACH IS_ ISSUED 
(CHART 24B/K4) 


NO 
c4 
Sa 
24H 
B4 
FROM NO CF 
24L/ U5 
D4 
a ® 
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WAIT FOR WORK 
24G 
54 
NO 
E2 E4 


FROM IIVIS 
(CHART 24B) 


SAVE CALLER'S 
REGISTERS 


VALID ENTRY NO 
CODE 


YES 


INITIALIZE 


DTFIS AND DCB 
POINTERS 


G2 
YES 
H2 
YES 
J2 
YES 
CODE=8 
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?. 
St 


YES 


RETURN 


Flowchart 


24F. 


Get Mapping Routine (IIVIS Part 6 of 11) 


FROM 24E/J2 


GETRTN Be B3 


NO 


QISAM SCAN 
SUPPORTED 


NO 


SET SETL BIT 
IN ISBLK 


}ISSUE OS GET 
MACRO 


MOVE RECORD TO 
DOS IOAREAS 
ADDRESS, SAVE 
ADDRESS FOR PUT 


SET GET BIT 
IN | SBLK 


Fe 


WORKS NO 
SPECIFIED 


MOVE RECORD TO 
WORKS ADDRESS 


FROM 
24G/J2 


NOP_LOAD IOREG 


INSTRUCTION _ IN 
TRAP CODE 


J2 


IOREG NO 
SPECIFIED 


CREATE CODE IN 


RETURN TO DOS 
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Flowchart 24G. Put and ESETL Mapping Routine (ITVIS Part 7 of 


FROM 24E/B4 


PUTRTN Be 


GET MACRO 
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NO 
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D2 
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MACRO 


Y 
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FROM 24E/D4 


ESETLRTN B4 


ISSUE OS 
ESETL MACRO 


CLEAR QISAM 
BITS IN ISBLK 


Flowchart 24H, 


Read Key and Write Kev Mapping Routines 


(TIVIS Part 8 of 11) 


FROM 24E/E4 


READRTN Be 


BISAM 
SUPPORTED 


IOAREAR=0 


LOAD ADDRESS OF 
KEY VALUE FOR 
READ SEARCH 


SET READ BIT 
IN ISBLK 


ISSUE OS READ 
MACRO TYPE=KU 


FROM 24E/C4 


WRTKRTN B4 


READ ISSUED 


WORKR 
SPECIFIED 


MOVE RECORD 


SS 
|IOAREAR ADDRESS 


MOVE RECORD 
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ISSUE OS 
WRITE MACRO 
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CLEAR READ 
BIT AND SET 
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Flowchart 24 J. 
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DCB OPEN 
FOR QI1SAM 
LOAD 


NO 


YES 


LOAD WORKL DATA 
AND KEY 


ADDRESSES FROM 
DTFIS 


De 


DATA SET 
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NO 
MOVE KEY 
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Write NEWKEY Mapping Routine (IIVIS Part 9 of 11) 


XY 


FROM 24E/G2 


WRTIKNRTN B3 WRTKN200 


B4 


YES OTF IS FOR NO BISAM NO 
LOAD SUPPORTED 


YES 


MOVE KEY VALUE 
TO DTF!IS KEY 


SAVE AREA 


LOAD WORKL 
ADDRESS _ INTO 
REGISTER 


E4 


BLOCKED 
DATA SET 


YES 


INCREMENT PAST 
KEY IN WORKL 


MOVE RECORD TO 
OS non OnED + 


SET WRITE 
NEWKEY BIT IN 
ISBLK 


Flowchart 


24K. 


FROM 24E/H2 


B2 B3 


WAITF FOR 
WRITE KEY 


WAILTF FOR 
READ KEY 


NO 


YES 

Ce 
YES ERROR_ON 
ERROR ON READ WRITE 
NO YES 


ISSUE OS 
CHECK MACRO 


SET READ 


MOVE RECORD TO 
1LOAREAR ADDRESS 


G2 


WORKR 
SPECIFIED 


NO 


MOVE RECORD TO 
WORKR ADDRESS 


RONOWORK 


NOP LOAD IOREG 
ENSTRUCTION_ IN 
TRAP CODE 


CREATE CODE TO 
DTF1S_ TO LOAD 
REGISTER UPON 
RETURN TO DOS 


WAITF Mapping Routine (IIVIS Part 10 of 11) 


B4 


WAITF FOR 
WRITE NEW KEY 


NO 


ISSUE OS 
CHECK MACRO 


CLEAR ALL 
BITS IN 


1/0 
|SBLK 
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Flowchart 24L. EODAD, SYNAD, and Status Mapping Routines 
(TIVIS Part 11 of 11) 


ENTERED WHEN AN 1/0 
ERROR OCCURS IN THE 
EMULATOR TASK OR 

SUBTASK 


FROM 
24L/C4, 
24L/D4, 
24L/G! 
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INITIALIZE 
ADDING DCB OPEN POINTERS FOR INITIALIZE BYTE 
RECORDS FOR QISAM LOAD STATUS LOOP COUNT TO 2 
SUPPORTED LOAD MODE MAPPING 


FROM 24D/G2, 
24F/U2, 24F/K2, 
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C5 


MAPSTSTC 24L/AlI 


MAP STATISTICS 
FROM DCB TO 
DTFIS 


MOVE STATISTICS 
TO DTFIS 


DCB OPEN 
FOR QISAM 


OSs 
EXCEPTION 
SCAN MODE 


BYTE 0 


FROM 24H/F2, 2 
24H/G4, 24K/D4 
24K/K2, 24K/K3 


NO 


MOVE LAST PRIME 
DATA RECORD 
ADDRESS TO 

DTFIS 


INITIALIZE MAPSTSTC 24L/A! 

POINTERS FOR 

BISAM_ STATUS MAP STATISTICS 

MAPPING FROM DCB TO 
DTFIS 


SCAN OS BYTE 
BIT BY BIT AND 
MAP STATUS TO 
DTFIS STATUS 
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DECREMENT BYTE 

LOOP COUNT AND 

SET POINTER FOR 
NEXT LOOP 
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FROM 24D/B1 

24F/B3, 24G/B2, 

24H/B2, 24H/C2, 

24H/B4, 24J/B2, 

24J/B4, 24K/B4 F5 


CREATE SVC 50 
INSTRUCTION_IN 

DTFIS TO BE FROM 
EXECUTED UPON 24K/Ce2, 


BYTE LOOP 
COUNT 0 


RETURN TO DOS 24K/C3 
24G/B4 
YES («s 
SETRTRN G5 
MAPSTSTC 24K/Alt 
SUBTASK_ IN 0 
MAP STATISTICS CONTROL 
FROM DCB TO 
DTFIS 
FROM IIVIS YES 


(CHART 24D) 


CLOSE QISAM 


COMPLETE I0B 
DCB TO I1SBLK 


CSW _FIELD_IN 
COMTAB ENTRY 


OPEN QISAM DCB 
IN ISBLK 


FROM 
24B/E3, 
24B/E4 


SET DCBMACR 

FIELD FOR 
ACCESS METHOD 
TYPE_OF MACR 

INSTRUCT 1ON 


ZERO OPEN CODE 
IN ITSBLK 


RETURN ISSUE POST 
MACRO FOR 


COMTAB ECB 
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vToc I/O Simulation Routines (Flowcharts 254-255) 


Module name: IIVVTIO 
Entry point name: IIvvVto 
Major functions (for shared volumes only): 


° Provides simulation of VTOC I/O from DOS open phases 
e Provides user label extent information from actual user label I/9 


Entered from: TIVPCE 
Modules called: None 
Exits to: caller 


OS macros issued: 


e SAVE 
e RETURN 
Input: 


° Pointer to DOS CCWs for I/O request 
° Pointer to the COMTAB for the volume on which I/O is requested 


Output: 


e Updated DOS CCW data areas (VTOC labels) 
° User label switch set to specify user label I/O requested 


Return codes: 

e CO - EXCP to be issued 

e 94 - I/O comvuletelyv simulated 

8 08 - CCW chain (channel program) not recognized 

Tables/work areas: 

e DOSCORE (CCW strings, CCW data areas) 

e Obtain work area (FO, F1 and F3 label values for the volume) 

e COMTAB (entrv for the volume on which I/O is requested) 

Errors detected: Invalid seek address (unrecognizable CCW string 
or seek address not within VTOC limits or user label 
extent) 


Messages requested: None 
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Command and Type Code Tables for the VTOC I/O Simulation Routine. The address 

of the routine to be executed, when exiting from the vVTOC I/O simulation routine 

(IIVVIO chart 25A), is in the branch register. This address depends on the 

table (see Figure 26) used at entry to VIOA2. ) 


COMMAND CODE TABLE TYPE CODE TABLE 


Code Routine Chart Code Rautine Chart 

X'O3° VIOB 25B/B1 X'FFt VIOIOA 25D/B1 
x'o7vt VIoc 25B/E1 K'gtt VIOTOB 25D/E1 
x'ost VIOD 25B/B2 X*82!* VIOIOB1 25D/G2 
xXx'3tt VIOE 25B/B3 ¥'21° VIOIOC 25D/B3 
x'29°% VIOF 25B/E2 X'*uat VIOLIOD 25D/B5 
¥'12' VIOG 25C/B1 X*5at VIOIOD 25D/B5 
Kt'oegt VIOH 25C/B2 x'ate VIOIOE 25E/B1 
X'OR? VIOT. 25C/B3 x' ict VIOTOF 25E/B3 
x'ost VIOJ 25C/BY4 xT5SC! VIOTOF 25E/B3 
X'topD* VIOJ 25C/B4 X'oor VIOERRX 25E/ FY 
X'O0t VIOEFRRX Z25E/ FY 


Figure 26. 
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Routine 


DOS Emulator Logic 


Command and Type Code Tables for the vToc T/O Simulation 


Flowchart 25A. 


ENTRY 


FROM _IIVPCE 
(CHART &8P) 


SAVE CALLER'S 


REGISTERS 


cl 


EXECUTING 
DOS OPEN OR 
CLOSE 


NO 


YES 


SET TYPE BYTE 
TO oO 


SET COMMAND 
CODE TABLE 
ADDRESS _IN WORK 
REGISTER | 


FI 


CCW COMMAND 
CODE A TIC 


YES 


25B 
B2 
NO 
Gi 
DOES TYPE YES 


BYTE INDICATE 
WRITE 


NO 


SET CCW 
SRL ar CODE 


N WORK 
REGISTER 0 


FROM 25C/F4 


FROM 25C/F5 


LOAD BRANCH 
REGISTER WITH 
TABLE ENTRY 


LAST ENTRY 
IN TABLE 


YES 


CODE _IN 
REGISTER 0 
EQUAL TABLE 
CODE 


* SEE TABLES 


INCREMENT 
WORK REGISTER 
{ TO POINT TO 
NEXT TABLE 
ENTRY 


VToc I/0 Simulation Routine (IIVVIO Part 1 of 5) 


IN FIGURE 26 
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Flowchart 25B. 


NO 


286 


FROM 
25A/C3, 
25A/D3 


GET DOS SEEK 
ADDRESS AND 
ADJUST TO TRUE 
ADDRESS 


USER LABEL 
EXTENT PRESENT IN 
OBTAIN AREA 


1S SEEK FOR 
USER _ LABEL 
TRACK 


1S SEEK FOR 
VOL! CCHH 


1S_ SEEK FOR 
VTOC CCHH 


NO PROCESSING 


DONE 


FROM 
25A/C3, 
25A/D3 


SET SKE FLAG 


SET USER 
LABEL FLAG ON 
IN COMTAB 


MOVE USER 
LABEL _EXTENT TO 
COMTAB I0B 


MOVE DCB 
POINTER TO 
COMTAB 10B 


SET RETURN 
CODE X°00* IN 
REGISTER 


DOS Emulator Logic 


vtoc I/O Simulation Routine (IIVVIO Part 2 of 


GET DOS ID 
ADDRESS AND 
ADJUST TO TRUE 
ADDRESS 


SET VOL1 FLAG 
ON IN TYPE BYTE 
x'so° 


[S_ SEARCH 
[ID EQUAL FOR 
Fl LABEL 


SET Fl FLAG 
ON IN TYPE BYTE 
x'40° 


IS F3 
PRESENT IN 
OBTAIN AREA 


1S SEARCH 
ID_EQUAL FOR 
F3 LABEL 


SET F3 FLAG 


5) 


Flowchart 25C. VTOC I/O Simulation Routine (TIVVIO Part 3 of 5) 


FROM FROM FROM FROM 

25A/C3, 25A/C3, 25A/C3, 25A/C3, 

25A/D3 25A/D3 25A/D3 25A/D3 
0 B OH B 


SET READ 
COUNT FLAG ON 
IN TYPE BYTE 
Xx'10’ 


SET READ DATA 
FLAG ON IN TYPE 
BYTE X'Qe°* 


GET DOS DATA GET DOS DATA 
ADDRESS, ADJUST ADDRESS, ADJUST 
TO TRUE + 


GET DOS DATA 
ADDRESS 
TO 
ADDRESS 
SAVE 


TO TRUE 
ADDRESS, AND ADDRESS, AND 


SAVE SAVE 


FROM 

25A/GI, 

25B/BI, 

25B/HI, 

25B/J1, 

25B/E2, 

25B/E3, VLONXT ¥ E4 

25B/F3, 

25B/C4, VLOLO 

25B/D4, 

25B/F4 SET TYPE 
1S COMMAND NO CODE TABLE 

CHAIN FLAG ON IN ADDRESS IN WORK 

CURRENT CCW REGISTER | 

FROM 

25B/B2 


YES 


INCREMENT CCW 
POINTER TO NEXT 
ccw 


SET TYPE BYTE 
IN WORK 
REGISTER oa 
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Flowchart 25D. 
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FROM 
25A/C3, 
25A/D3 


NO PROCESSING 
DONE 


FROM 
25A/C3, 
25A/D3 


SET DATA 
ADDRESS 


MOVE VOL! KEY 
TO DOS DATA 
AREA 


FROM 
25A/C3, 
25A/D3 


INCREMENT 
DATA ADDRESS BY 
KEY LENGTH 


SET DATA 
ADDRESS 


MOVE VOL! DATA 
TO DOS DATA 


AREA 
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SET _F3 
FIRST EXTENT 
ADDRESS AND 
EXTENT COUNT 
TO 4 


VIOIOX2 25E/A5 


CHECK EXTENTS 


SET F3 
FIFTH EXTENT 
ADDRESS AND 
EXTENT COUNT 
To 9 


VIOLOX2 25E/A5 


CHECK EXTENTS 


SET DATA 
ADDRESS 


MOVE F3 LABEL 


TO DOS DATA 
ADDRESS 


vtoc I/O Simulation Routine (IITVVIO Part 4 of 5) 


SET 
FIRST EXTENT 
ADDRESS AND 
EXTENT COUNT 
TO 3 


VIOIOX2 25E/A5 


CHECK EXTENTS 


GET DATA 
ADDRESS 


MOVE Fi DATA TO 
DOS DATA AREA 


READ COUNT 
FLAG ON IN 
TYPE BYTE 


Flowchart 25E. 


FROM 
25A/C3, 
25A/D3 


VIQIO . 
SET Fl 


FIRST EXTENT 
ADDRESS AND 


CHECK EXTENTS 
DD 


GET DATA 
ADDRESS 


MOVE Fi KEY AND 


DATA TO DOS 
DATA AREA 


VIOLO s 


SET DATA 
ADDRESS 


MOVE Fi COUNT 


TO DOS DATA 
AREA 


NNN 
Anny 
00000 
~~~ NZ 
NOL 
NW — 


VIOIQSIM 


SET SIMULATE 
RETURN CODE 
X'04° 


FROM 
25B/Ke 


RESTORE 


CALLER'S 
REGISTERS 


RETURN 


POINT TO NEXT 
EXTENT 


SET ERROR 
RETURN CODE 
x*'0O8° 


vVToc I/O Simulation Routine (IIVVIO Part 5 of 5) 


FROM IIVVIO 
(CHARTS 25D, 
25E} 


B5 


[S EXTENT 
TYPE 81 


NO 


SET EXTENT 
TYPE TO 01 


RETURN 


NNANNT 
Onna 
>> O>o 
~~~ 
DOLO 
ww — 
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Abnormal End Conditions 
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EXit-ABEND Frror Routine (Flowcharts 2?6A-26B) 


Module name: JYIVABN 
Entry point name: JIVABN 
Major functions: 


° Determines if the return to OS at the end of emulation is normal 
e Examines the error code passed from the module in which the error 
was found and prints the proper message if the calling routine 

has not already done so 

e Nequeues any queued resources 

e Posts 'CSW stored't condition code and status bits for channel 
end-program check to DOS if error concerns only one DOS partition 

e Snaps DOS registers and storage usina SNAP macro if module ITVRAS 
not present; if TIVRAS is present, an TIVRAS printout is given 

e Returns to OS if emulation ending 


Entered bv: 


ITIVINT 
TIVPCE 
TIVOPN 
IIVRTE 
TIVENT 
TIVGET 
J IVCHK 
LIVSVC 
TIVSNP 
TIVRCP 


Modules called: 


e ITIVRAS 
e TIVMSG 


Exits to: 


e Caller 
e OS 


OS macros issued: 


SNAP 
DEO 
LOAD 
SAVE 
RETURN 
DCB 
OPEN 


Input: 
° Error code in register RP1EU 
e Addressability in register RBOCD 
e Addressability to COMTAB in RPOEU if entered from TIVCCW at SIO time 
Output: 
° Snap of contents of DOS registers and storage area at abnormal 
end of emulation 
° DOS CSW and condition code if DOS should end a partition 


Return codes: None 
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Tables/work areas: 


CSW 

COMTAB 

CCW 

DCB for SNAPs 

IIVCON - Emulator constant area 
Local execution list 

[TIVRAS constants 


Errors detected: None 
Messages requested: 


TIV202T (TIVPCE detected error) 
IIVv203T1 
TIV2001I (TIVCCW detected error) 
TIV205I (IIVPCE detected error) 
TIV207T 
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Flowchart 26A. Exit-ABEND Error Routine (TIVABN Part 1 of 2) 


11VABN 
FROM I11VENT (CHART ENTRY 
1A), LIVINT (CHART 
2L)”11VOPN (CHARTS 
5B, 5C), IIVGET 
(CHART 7A), IIVPCE FROM 122/J2 FROM 26B/C2 
(CHARTS 8J, 8M) 26B/C3, 26B8/D3 
I1IVCHK (CHART 9B) 
[EVRTE (CHARTS 208 
20G), LIVSVC (CHART 
(7A). LIVRCP (CHART ABSNAP ¥ B4 
arate ILIVSNP (CHART DB RR = 


TIVMSG 123A 


ISSUES MESSAGE 
T1V2otl 


ESTABLI 


S SNAP DD 
ADDRESSABIL 


STATEMENT 
PRESENT 


NO 


H 
I 


TY 
C2 
YES 
ERROR CODE 4 
NO 
D2 
WRITE SNAP ID, 
YES DOS STORAGE 
ERROR CODE 8 SNAP, DOS 
REGISTERS SNAP 
NO 


26B 
Be 


E2 
1IVMSG 27A/A1 
YES 
ERROR CODE 12 [SSUES MESSAGE 
11V2031 
NO 
F2 
SET PSW CC TO 
YES *O!" AND CSW 
ERROR CODE 16 STATUS TO 
CHANNEL. END 
PROGRAM CHECK 
NO 
G2 
ata 
11VMSG 27A/AI 
YES 
ERROR CODE 20 ISSUES MESSAGE 
11v2041 


SERVICE 
AIDS ACTIVE 


TURN OFF BUSY 
BiT IN COMTAB 


AJ 


POST 10B CAW + 
8 TO DOS CSW RETURN 


IIVMSG 27A/Al1 
ERROR CODE 24 ISSUES MESSAGE 
11v2051 
NO 


ERR | Je 


SERVICE 


1IVRAS 28A/A\ 
YES 
AIDS ACTIVE 


LOAD IIVRAS TRACE AND SNAP 
ROUT INE 


K2 
ae 
DEQUEUE . 
NON-DASD 
COMTAB BUILT NON-STAGED RETURN 
RESOURCES 
TO OS 
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Flowchart 26B. FExit-ABEND Error Routine (IIVABN Part 2 of 2) 


FROM 26A/D2 


]1I1VMSG 2TA/AI 


ISSUES MESSAGE 
11V2021 


TESTS TO 


OCCURRED 


D 
IIVMSG 2TA/A1 


ISSUES MESSAGE 
IIV2oTI 
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Message Writer 
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Message Writer Routine (Flowchart 27A) 


Module name: IIVMSG ) 


Entry point name: IIVMSG 


Major function: Prints messages using OS WTO or WTOR services. 
The messages are on behalf of all the Emulator modules. 


Entered by: 


TIVINT 
TIVIN2 
IIVPUB 
ITIVCHK 
ITVADD 
TIVPRP 
LTIVGET 
TIVOPN 
ITIVSTG 
IIVRTE 
ITVABN 
LIVPCE 
TIVRCP 
IIVGR2 
TIVDVS 
TIVRCW 


Modules called: 


e TIVMG1 
e TIVMG2 
e TIVMG3 


Exits to: Caller J 


OS Macros issued: 


WTO 
LOAD 
SAVE 
WTOR 
DELETE 
RETURN 


Input: 
Message code 

e Supplemental data, if applicable 

e Parameter list with reply address, length, and ECR, if 
applicable 

Output: Message printed to the console 

Return codes: None 

Tables/work areas: 

° MSGINDX table in each of the message text modules, TIVMG1, 
TIVMG2, and IIYMG3 

e EMUCONS 


Errors detected: None 


Messages requested: None > 
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Flowchart 27A. Message Writer Routine (TIVMSG) 


6c, 6D, 


(CHARTS 8M, oP) 
(CHART 9D), 


FROM 
2F, 
TIVIN2 
3E 
ap}, 
5c) 
A (CHART TA), 
ENTRY IIVSTG 
11 
21B 
TV 
22C 
23F 
(CH 
11v 
11V 
E LIV 
STANDARD 
REGISTER 
LINKAGE 
DETERMINE 
REQUIRED MODULE 
tS ANY 
MODULE LOADED 
1S MODULE YES 
THE ONE 


REQUIRED 


ISSUE DELETE 
FOR LOADED 
MODULE * 


ISSUE LOAD 
FOR Se aa 
MODULE 


SAVE MODULE 
NUMBER AND 
ENTRY POINT 


(CHARTS 2E, 
, 2H, 20, 2 
(CHARTS 3B 
(CHARTS 5B, 
(CHARTS 6B, 


PM-->T < 


GET MESSAGE 
INDEX TABLE 


POINTER AND 
MESSAGE TEXT 


SET FOR WTO 
ENTRY TO 
MESSAGE WRITER 


DOES 
INPUT 
REGISTER FOR 
FILL HOLD 
ZEROS 


YES 


IS FILL FOR 
A WTO 


SET FOR WTOR 
ENTRY TO 
MESSAGE WRITER 


DOES 
REGISTER 
POINT TO FILL 
DATA 


REGISTER MUST 
POINT TO WTOR 
LIST; MOVE IF 
IN WIOR AREA 


FILL DATA 
REQUIRED 


COMPUTE NUMBER 
OF CONTROL 
BYTES PRECEDING 
MESSAGE TEXT 


MOVE THE 
MESSAGE TEXT TO 
WTOR AREA 


MOVE FILL DATA 
INTO WTOR AREA 


MOVE MESSAGE 


LENGTH, 

DESCRIPTOR, AND 

ROUTE CODE INTO 
WTOR AREA 


MOVE JOB NAME 
INTO_MESSAGE 
TEXT 


RETURN TO 


CALLER 


* SEE "DIAGNOSTIC AIDS" 
FOR MESSAGES CONTAINED 
IN MODULES 11VMGI 
11VMG2, AND [| VMG3. 
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Emulator Service Aids 
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Service Aids Initialization Routine (Flowcharts 28A-283) 


Module name: TIIVRAS 
Entry point names: 


ITIVRAS 

TIVRASPC 
JIVRASVC 
ITIVRASYM 


Major functions: 


e Tnitializes fields in TIVRCN 
e Establishes addressability after program checks, supervisor 
calls, and asynchronous interruptions during local execution mode 


Entered by: 


TIVIN2 

TTVABN 

TIVPRP 

Hardware (ITVRASVC, IIVRASPC, and IIVRASYN addresses placed in 
Svc, PC, and ASYNC interruption fields respectively in the LEX 
list) 


Modules called: 


TIVRCP 
Asvnchronous user exit routine (TTVRASnn) 
TIVSNP 
TIVMSG 


Exits to: 


e Caller 
© ITIVPCI 
e TIVSCTI 
e ITVRTE 


OS macros issued: 


SAVE 
DELETE 
RETURN 
TIME 
LOAD 
OPEN 


Input: 


e Fields in TTVRCN (RASCONS) 
e Register 0 - 0 caller from IIVPRP or IIVIN2 


4 = snap out trace table, caller from IIVABN 
8 = snap DOS hard wait, caller from TIVABN 
e Register 1 - contains option in effect if register 0 contains 8 


Output: Initializes fields in TIVRCN 


Return codes: None 
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Tables/work areas: 

e  IIVRCN (RASCONS) 

e Local execution list 
¢ JIVCON (EMUCONS) 
Errors detected: None 


Messages requested: T1IV2731 
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Flowchart 28A. Service Aids 


N2 (CHART 
RP (CHART 
AB 
A} 


SAVE REGISTERS 


AND _ PERFORM 
HOUSEKEEPING 


cl 


IS CALLER 
11 VABN 


YES 


DI 


SET UP_OPTION 
IN EFFECT 
*TRACE’ 


TRACE TABLE 
SNAP 


SET UP OPTION 
IN EFFECT FROM 
CALLER 


FI 


HAS 11VSNP 
BEEN LOADED 


NO LOAD MODULE 


TT VSNP 


SWAP _ INTERRUPT 


ADDRESSES 


SWAP _ INTERRUPT 
ADDRESSES AGAIN 


IIVSNP 30A/At 


SNAP EMULATOR 
CONTROL BLOCKS 


OPEN DCB FOR 
SYSSNAP IF NOT 
ALREADY OPENED 


C4 


NO 


YES 


INITIALIZE 


HEADER FOR 
LI VRCP 


E4 


1S MODULE 
I 1VSNP_IN 
STORAGE 


YES 


LOAD MODULE 


11VRCP 


TIVRCP 29A/Al1 


PROCESS SERVICE 
AIDS COMMANDS 


DELETE MODULE 


LI VRCP 


J4 


NO 


LOAD I |VSNP 


LOAD MODULE 
LI VSNP 
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Initialization Routine (IIVRAS Part 1 of 2) 


IIVMSG 2TA/AI 


ISSUES MESSAGE 
[1VeT73l 


DELETE MODULE 
T1VSNP 


RETURN 


301 


Flowchart 28B. 


IIVRASPC, IIVRASVC, 


(TIVRAS Part 2 of 2) 


FROM DOS VIA FROM DOS 
A PROGRAM VLA AN 
CHECK 


svc 


SAVE DOS 


SAVE DOS 
REGISTERS REGISTERS 


SET UP 
EMULATOR 
REGISTERS 


SET UP 
EMULATOR 
REGISTERS 


VPCI TO IIVSCI 
T SIA) (CHART 32A) 
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ENTRY 


FROM OS VIA AN 
ASYNCHRONOUS 
INTERRUPTION 


SAVE DOS 


REGISTERS 


SET UP 
EMULATOR 
REGISTERS 


D) 
I LVRASNN 


USER 
ASYNCHRONOUS 
EXIT ROUTINE 

E3 


NO 


OPTIONAL SNAP 


SWAP_ INTERRUPT 
ADDRESSES 


1iVSNP 30A/A\ 


SNAP EMULATOR 
CONTROL BLOCKS 


SWAP_ INTERRUPT 
ADDRESSES AGAIN 


RESTORE DOS 


REGISTERS 


EXIT 
O TIVRTE 
(CHART 20B) 


and TIVRASYN Subroutines 


Command Processor Routine (Flowcharts 29A-29P) 


Module name: IIVRCP 

Entry point name: TIIVRCP 

Major functions: 

Reads a debug statement from card input or console reply 
Checks the validity of the statement 


Sets adequate indicators in RASCONS 
Loads service aids processor IIVACI, YIVPCTI, TIVScr 


Entered by: ITIVRAS 
Modules called: IIVMSG 
Exits to: 


e TIVABN 
° Caller 


OS macros issued: 


OPEN 
CHECK 
DELETE 
FREEMAIN 
WRITE 
LOAD 
GETMAIN 


Input: 

e Pointer to local execution list 

e Pointer to Emulator constants 

e Service aids constants 

Output: Indicators and switches in RASCONS 


Return codes: In register 15 


Tables/work areas: 


e Local execution list 
° EMUCONS 

e RASCONS 

e 


DCB for SYSDEBUG data set 

Errors detected: Syntax errors in debug statement 
Messages requested or issued: 

IIV270I (on console) 

IIV271I (on console) 


TIV274~I (on console) 
ITV2761 
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Dictionaries for IIVRCP. The CMDDICT (Figure 27) lists each command, the 

routine that initializes each command, the routine that resets each command 

after an error is detected, and the associated dictionary to handle the 

parameters or keyword parameters of each command. ) 


The SNPDICT (Figure 27) lists each parameter or keyword parameter (under heading 
'Name of Keyword') of the SNAP command and the name and chart number of the 
routine to process each parameter. 


The TRCDICT (Figure 27) lists each parameter or keyword parameter (under heading 
'Name of Keywordt) of the TRACE command and the name and chart number of the 
routine to process each parameter. 


The STODICT (Figure 27) lists each parameter or keyword parameter (under heading 
'Name of Keyword't) of the STORAGE command and the name and chart number of 
the routine to process each parameter. 


The EXIDICT (Figure 27) lists each keyword parameter (under heading 'Name of 
Keyword!) of the EXIT command and the name and chart number of the routine 
+o process each keyword parameter. 


The DIAGDICT (Figure 27) lists the keyword parameter of the DIAG command and 
the name and chart number of the routine to process the parameter. 
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CMDDICT - Command Dictionary 


Name of | Routine to Routine to Associated 
Command | Initialize Reset Keyword 
Dictionary 


fe [enact [me [eae 


DIAGINIT | 29L/A1 DIAGINV 29L/A1 DIAGDICT 
ENDINIT 29N/A1 

EXIINIT 29M/A1 EXIINV 29M/A1 EXIDICT 

SNPINIT 29G/A1 SNPINV 29G/A2 SNPDICT 

STOINIT 29K/A1 STOINV 29K/A1 STODICT 

TRCINIT 29E/A1 TRCINV 29E/A2 TRCDICT 


SNPDICT - Snap Dictionary 


Name of Routine to Process 
Keyword 


SNPALL 293/G3 
SNPATTN 29H/D4 
SNPCOMP 29H/A1 note 
SNPCUU 295/A1 
SNPEXT 29A/A5 
SNPHIO 29J/A5 
SNPINT 29H/D5 
SNPIO 29.3/G2 
SNPISK 29J/D3 
SNPLPSW 293/D5 
SNPPC 29H/G4 
SNP PSW 29G/C2 
SNPSIO 29T/A2 
SNPSSK 293/D4 
SNPSSM 29I9/D2 
SNPSVC 29G/A3 note2 
SNPTCH 293/A4 
SNPTIMER 29H/A4 
SNPTIO 293/A3 
note If COMP=A111111=Ehhhhhhh is specified, the routine name to process 


hhhhhhhh is SNPCPSUB. {See chart 29H/A3.) 


note2 If SVC=PHASE=(modname1,modname2) is specified, the routine name to 
process modnamel cr modname2 is SNPSUBOP. {See chart 29G/H5.) 


* This indicates a keyword parameter. All others are called parameters. 


Figure 27 (Part 1 of 2). Command Processor Routine Dictionaries 
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TRCDICT - Trace Dictionary 


Name of Routine to Process 
Keyword 


TRCATTN 29F/G3 
TRCCUUD 29F/A2 
TRCEXT 29F/A4 
TRCHIO 29E/C5 
TRCINT 29F/D3 
TRCIO 29F/A1 
TRCISK 29E/F3 
TRCLPSW 29E/F5 
NOWRAP TRCNWRAP| 29F/E1 
WRAP TRCWRAD 29F/H1 
NUMBER* TRCNUMBR| 29F/D4 
SIO TRCSIO 29E/C2 
SSK TRCSSK 29E/F4 
SSM TRCSSM 29E/F2 
SVC TRCSVC 29F/A5 
TCH TRCTCH 29E/C4 
TIMER TRCTIMER| 29F/A3 
TIO TRCTIO 29E/C3 
WRAP TRCWRAP 29F/4H1 


TRCALL 


29F/H5 


STODICT - Storage Dictionary 


ALL 
DOS 
EMBLKS 
EMU 
NODOS 


NUMBER* 


Routine to Process 


STOALL 
STODOS 
STOEMBLK 
STOEMU 
STONODOS 
STONUMBR 


29K/A5 
29K/E2 
29K/A3 
29K/A4 
29K/E3 
29K/E4 


EXIDICT - Exit Dictionary 


Name of 
Kevword 


Routine to Process 


EXTAS 
EFXILEX 
EXIPC 
EXISVC 


29M/A5 
29M/A4 
29M/A3 
29M/A2 


DIAGDICT -- Diagnostic Dictionary 


Routine to Process 


Chart 


DIASCCW 29L/A4 


* This indicates a keyword parameter. 


All others are called parameters. 


Figure 27 (Part 2 of 2). Command Processor Routine Dictionaries 
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Flowchart 29A. 


LLVREP A 2oA 
Bis FROM 29B/E2 


ENTRY 


FROM IIVRAS 
(CHART 28A) 


ML) OO = 


LEVEL EQUAL 0 


FROM 29B/E2 


LEVEL EQUAL |! 


D 
GETWORD 29C/AI1 GETWORD 29C/Alt 


GET NEXT NAME GET NEXT NAME 


Et Ee 


CLEAR 
PARENTHESIS 
COUNTERS 


LEVEL EQUAL 2 


GETWORD 29C/A1 


GET NEXT NAME 


%* KEYWORD 


GO PROCESS KEYWORD 
PARAMETER AND VALUE 
(OPERAND ) 


NO NAME FOUND 


NO 
IN CMDDICT # 


NAME FOUND 
IN KEYDICT® 


(«5 ) YES (ss ) YES 
F2 
YES 
INITIALIZE 
COMMAND 
Gi 
NO 


MUST HAVE A 
KEYWORD 
SUBPARAMETER 
(SUBOPERAND } 


YES MUST HAVE A 
VALUE 


(OPERAND) 


Ht 
*® KEYWORD 
YES “MUST HAVE A 


KEYWORD GO PROCESS 


PARAMETER 


(KEYWORD) 


29B 
298 Be 
B5 


FROM 29B/De2 


Command Processor Routine (IIVRCP Part 1 of 14) 


FROM 29B/C2 


RCPPRINT 29D/A5 


LEVEL EQUAL 3 PRINT LINE ON 


SYSSNAP 


|) 4 
GETWORD 29C/AlI 
GET NEXT NAME 


SET FLAG TO 
HAVE NEW CARD 
AND ERROR 


GO PROCESS COMP 
AND SVC 
( SUBOPERAND } 


*® SYMBOL TABLE 


NOTE: SEE FIGURE 27. NAMES 
IN PARENTHESES ARE THOSE 
USED IN LISTING. 


CMDDICT -- COMMAND 
DICTIONARY (SEE 
FIGURE 27) 


KEYDICT -- KEYWORD 
DICTIONARY. DEFINES THE 
KEYWORD ATTACHED WITH THE 
COMMAND _ IN CMDDICT (SEE 
FIGURE 27) 


KEYWORD -- KEYWORD AND 

NAME. OF ROUTINE TO BE 
PROCESSED (SEE TRCDICT, 
STODICT, EXIDICT 

DIAGDICT, SNPDICT, FIGURE 27) 


INIT -- ROUTINES TO 
INITIALIZE EACH COMMAND 
(SEE CMDDICT FIGURE 27) 


SUBOP -- ADDRESS OF THE 
ROUTINE IS STORED BY _ THE 
ROUTINE THAT PROCESSES 
THE OPERAND (SEE FIGURE 
a (COMP AND 
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Flowchart 


308 


298. 


29B 
Be 


DELOO Be 


DELIMITER 
COMMA 


YES 


C2 


ANY 
PARENTHES 
IN LEVEL 


YES 


NO 


D2 


ANY 
YES PARENTHES 
IN LEVEL 
NO 


Ee 


ANY 
PARENTHES 
IN LEVEL 


YES 


NO 


DOS Emulator Logic 


A 


ES 
3 


ES 
2 


ES 
{ 


Command Processor Routine 


NO 


B3 


DELIMITER RIGHT 
PARENTHESIS 


NO 


YES 


DECREMENT LEVEL 
BY ONE 


NO 
D4 
ANY 
PARENTHESES 
IN COUNTER 
FOR LEVEL 
YES 
29A 
B5 


DECREMENT 

NUMBER OF 
PARENTHESES IN 
eoutee FOR 


BUMP POINTER TO 
INPUT BUFFER BY 
ONE 


NEXT CHARACTER 
1S RIGHT 
PARENTHESIS 


NEXT 
CHARACTER IS 
BLANK 


BUMP_POINTER TO 
INPUT BUFFER BY 
ONE 


MOVE THIS 
CHARACTER INTO 
RCPDEL 


BUMP POINTER TO 
INPUT BUFFER BY 
ONE 


(ITIVRCP Part 2 of 14) 


FROM 
29B] 29A/HI 
BS 


DELFF B5 


END OF BUFFER 


ANY 
PARENTHESES 
LEFT 


AFTER AN 
END COMMAND 


YES 


PRESENT 


RESTORE 
CALLER*S 
REGISTERS 


RETURN 


NO 


29A 
BS 


Flowchart 29C. GETWORD Subroutine (IIVRCP 


GE TWORD A 
ENTRY FROM 29A/DI, 
29A/D2, 
29A/D3, 29A/D4 
Bt 
NEED A NEW NO 
CARD 
YES 


RESET NEW CARD 
SWITCH 


GETWO D1 


INPUT FROM 
SYSDEBUG 


PREVIOUS 
CARD IN ERROR 


FIRST TIME 
THROUGH 


I IYMSG 27A/AI 


ISSUES MESSAGE OPEN SYSDEBUG 
L1V2741 


SET RETURN TO 
[1VABN GET A CARD 
: READ {OO +} 
EXIT 


RCPPRINT 29D/A5 


PRINT CARD ON 
SYSSNAP 
TO I1IVABN 


{CHART 26A) 


CLEAR CONSOLE 
REPLY BUFFER 


TIVMSG 2TA/AI 


SSUES MESSAGE 


WAIT FOR REPLY 


CVTUPP 29D/AlI 


UPPER CASE 


Part 3 of 14) 


CLEAR RCPCUR, 
INITIALIZE 
SWITCHES, 

LENGTH 


CHARACTER BUMP POINTER TO 
BLANK STRING BY ONE 


CHARACTER RIGHT BUMP 
PARENTHESIS PARENTHESIS 
COUNTER BY ONE 


NO 
E4 E5 


CHARACTER 
X*FF* (END OF 
CARD) 


YES NO 
AFTER A COMMA 


MOVE CHARACTER 
IN RCPCUR 


BUMP POINTER TO CHECK RCPCUR _IS 
STRING BY ONE ALPHANUMERIC 


~ 


SPEC1AL 
CHARACTER 


ANY_ INVALID 
CHARACTERS 


MOVE CURRENT 
RCPLNG +1 CHARACTER 
POINTER IN 
RCPCUR +1 


CALLER +4 


RETURN 


TO CALLER 
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Flowchart 29D. CVT and RCPPRINT Subroutines (IIVRCP Part 4 


ENTRY 


FROM FROM 29F/D5, FROM 
29C/G3 29OF /E4, 29G/Fe, 
29G/F3, 29H/D3 
29H/ Je, 
29K/F4, 
29M/C3 


CONVERT 
CHARACTER TO 


SET FLAG FOR 


PROPAGATE FO 
CVTSTR 


SET FLAG FOR 


NUMER IC 


MASK CONVERSION 
CONVERS | ON 


UPPER CASE 


ADD_ 1 TO 
POINTER INTO 
STRING 


PROPAGATE 'FF° 
IN CVTWORK2 


PROPAGATE * IN 
CVTSTR 


D3 


MOVE NAME AND NO MASK 


CONVERSION 


YES MOVE NAME AND 


PAD LEFT IN 


PAD RIGHT IN 
CVTSTR 


CVTSTR 


RETURN 


TO CALLER 


CHARACTER 
IN CYTSTR IS 
BLANK 


PACK CVYTSTR 
CVTWORK 


IN 


BUMP POINTER 
CVTSTR_AND 
CVTWORK2 


TO CHARACTER 


IN CVYTSTR [5 
DIGIT 


NUMER IC 
CONVERSION 


MASK 
CONVERS ION 


REPLACE BY 

IN CVTSTR: 
"FO" IN 
CVTWORK2 


"Fo? 
MOVE 


CHARACTER 
IN es i) 


PACK CVTWORK2 
AND STORE BACK 
IN CVTWORK2 


REPLACE 
CHARACTER IN 
CVTSTR BY FA 

THROUGH FF 


CHARACTER 
1S CVTSTR IS 
A ESN 


310 DOS Emulator Logic 


Of 14) 


FROM 
29A/C5, 
29C/H2 


BS 


MORE LINES 


ON PAGE 


COMPUTE PAGE 


NUMBER 


RESET 


LINE COUNT 


WRITE PAGE 


CONVERT 
BINARY 
IN cvtWoRK 


SHIFT RESULT 
ACCORDING TO 
LENGTH WANTED 


SET RETURN TO 
CALLER +4 


HEADING 


RETURN 


TO CALLER 


INTO 
STORE 


RETURN +4 


TO CALLER 


Flowchart 29E. 


TURN ON_*TRACE 
WANTED* 
RASTRSW2 


TURN OFF 
RASTRSWI, 
RASTRSW3, 
RASTRSW4 


CLEAR OP_CODE 
TABLE 


CLEAR CUL) TABLE 


DEFAULT IN 
TRACE TABLE 
SIZE 


RETURN 


ENTRY 


FROM 
29N/C5 


TURN OFF ‘TRACE 
WANTED‘ 
RASTRSWe 


MOVE SIO 
CODE IN OP 
TABLE 


RETURN 


MOVE SSM OP 
CODE IN OP CODE 
TABLE 


RETURN 


FROM 
29A/H2, 
29A/E3 


MOVE TIO OP 
CODE IN OP CODE 
TABLE 


RETURN 


MOVE ISK OP 
CODE IN OP CODE 
TABLE 


RETURN 


Trace Subroutines ({IIVRCP Part 5 of 14) 


FROM 
29A/H2, 
29A/E3 


MOVE TCH OP 
CODE IN OP CODE 
TABLE 


RETURN 


MOVE SSK OP 
CODE IN OP CODE 
TABLE 


RETURN 


Program Organization 


MO 
CODE 


VE HIO OP 
IN OP CODE 
TABLE 


RETURN 


MOVE LPSW OP 


CODE 


IN OP CODE 
TABLE 


RETURN 


Flowchart 29F. Trace Subroutines (IIVRCP Part 6 of 14) 


TRC 


TR A 
ENTRY 


FROM FROM FROM FROM 
29A/He, 29A/H2, 29A/He, 29A/H2, 
29A/E3 29A/E3 29A/E3 29A/E3 


B2 


TURN ON ‘*TIMER* 
IN RASTRSW3 


TURN ON ‘°1/0 
WANTED ® 
RASTRSWI 


TURN ON ‘EXT® 
IN RASTRSW3 


MOVE ALL [/O OP 
CODES_IN OP 
CODE TABLE 


RETURN 
CLEAR CUU TABLE 


RETURN 


29A/He, 
29A/7E3 


CVTNUM 129A2 


CONVERT BINARY, 
LENGTH 2 


TURN ON ‘INT? 
IN RASTRSW3 
MOVE T1O IN OP 
CODE 


GET POINTER TO 
FIRST AVAILABLE 
CUU 


FROM 
29A/H2, 
29A/7E3 


CVTHEX 29D/A3 


CONVERT, RESULT 
e BYTES 


RETURN TEST AT LEAST 


ONE TRACE 


TURN ON *NO 
WRAP* SWITCH 


RETURN MOVE TRACE 
ENTRIES NUMBER 


IN TRCTBLNO 


MOVE CUU IN CUU 
TABLE 


FROM 
29A/H2, 
29A/E3 


RETURN TURN ON 
‘ATTENTION’ IN 
RASTRSW3 


RETURN 


TURN OFF *NO 
WRAP* SWITCH 


RETURN 


RETURN 
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FROM 
29A/H2, 
29A7E3 


TURN ON *SVC* 
IN RASTRSW3 


OPERAND 
SPECIFIED 


NO 


CVTNUM 29D/A2 


CONVERT SVC 
INTO 
HEXADEC I MAL 


MOVE X°FF?* IN 
CORRESPOND ING 
POSITION OF SVC 

TABLE 


PROPAGATE X‘FF* 
IN SVC TABLE 


RETURN 


TURN ON ‘ALL* 
IN RASTRSW4 


RETURN 


Flowchart 29G. Snap Subroutines (IIVRCP Part 7 of 18) 


SNPLA A SNP LN A SNP A 


ENTRY ENTRY ENTRY 


FROM 29A/F 4 FROM FROM 29A/He, 
29N/C5 29A/E3 (e+ ) 


nvunan 
000 


Crro 
~~ SZ 


B3 SNPSV11 B4 SNPSV50 


TURN ON °SNAP 
WANTED®* 
RASNPSWe2 


TURN OFF *SNAP NO 
WANTED? 
RASNPSW2 


NEXT 
POINTER 


Svc 
IS 0 


YES YES 


CLEAR COMPARE 
BLOCKS { AND 2 


TURN ON °SVC* 
IN RASNPSW3 


POINT TO NEXT 
SVC BLOCK 


FROM 
29A/He, 
29A/E3 


CLEAR SVC 
CHAIN, SVC 
POINTER 


TURN ON ‘PSW" 
SWITCH 


CLEAR SVC 
CHAIN, SVC 
POINTER 


GETMAIN FOR A 
NEW SVC BLOCK 


MOVE SVC NUMBER 
YES IN BLOCK, O IN 


NEXT, 6 IN 


CLEAR PSW VALUE 
AND MASK 


MOVE EBCDIC 
CHARACTERS IN 
RASCONS 


TURN ON 
* SUBOPERAND 


MOBNAME REQUIRED* 


CVTNUM 29D/A2 


GIVE SNPSUBOP 
ADDRESS FOR 
SUBOPERAND 
PROCESSING 


CLEAR SNAP 
SWITCHES 1,3,4 
RASNPSW1 ,354 


SAVE ADDRESS OF 

CONVERT SVC IN THIS SVC BLOCK 

BINARY, ONE 
BYTE 


G4 


CLEAR 1/0 OP 
CODE TABLE 


MOVE MASK _IN 
RASCONS 


AFTER A RETURN 
SUBOPERAND 


SAVE SVC NUMBER 


SNPSUBOP . 
LOCATE 
CLEAR SNAP CUU MOVE HEX BEGINNING OF MOVE MODULE ENTRY 
TABLE ADDRESS VALUE SVC CHAIN IN NAME IN SVC 
IN RASCONS RASCONS BLOCK 
FROM 
29A/E4 
J5 


CLEAR PC AND 
IPL SWITCHES 


RETURN CLEAR ADDRESS 


OF SVC BLOCK 


0_IN YES 
ADDRESS OF 
SVC BLOCK 


RETURN RETURN RESTORE ADDRESS 


OF CURRENT SVC 
BLOCK 
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Flowchart 29H. 


Snap Subroutines (TIVRCP Part 8 of 14) 


SNPCOMP A SNPCP SUB A SNP. 
ENTRY ENTRY 
FROM FROM FROM FROM 
29A/He, 29A/E4 29A/He, 29A/He, 
29A/E3 29A/E3 29A/E3 
BI B3 
MOVE HEX IS THIS 
NO ADDRESS VALUE NO REGISTER TURN ON ‘TIMER’ TURN ON ‘EXT? 
IN COMPARE COMPARE (CR) IN RASNPSW3 IN RASNPSW3 
BLOCK | 
YES 


BLOCK | 


YES 


CLEAR COMPARE 


COMPARE BLOCK 2 


AVAILABLE 
COMPARE BLOCK 
2 


POINT TO NEXT 
COMPARE BLOCK 2 


SET SWITCH 
* SUBOPERAND 
REQUIRED’ 


STORE ADDRESS 
OF ROUTINE TO 
PROCESS KEYWORD 
SUBPARAMETER 
{ SUBOPERAND } 


RETURN 


PAD LEFT WITH 
ZEROS UP TO 4 
BYTES 


CVTMSK 29D/A4 


CONVERT HEX 
ADDRESS PLUS 
MASK, 4 BYTES 


MOVE HEX 
ADDRESS VALUE 
IN COMPARE 
BLOCK | 


RETURN 


FROM 
29A/He, 
29A/E3 


TURN ON 
‘ATTENTION’ IN 
RASNPSW3 


RETURN 


FROM 
29A/He, 
29A/E3 


TURN ON ‘INT* 
IN RASNPSW3, 
MOVE HIO IN 
OPCODE TABLE 


COMPUTE 
CORRESPONDING 


MOVE MASK IN 

COMPARE BLOCK 

{, EBCDIC IN 
COMPARE BLOCK 2 


RETURN 


COMPARE BLOCK 1 
ADDRESS 


GI 
CVTHEX 29D/A3 
YES CONVERT AND CHECK RESET SWITCH 
DOS ADDRESS, MOVE * SUBOPERAND 
EBCDIC IN COMPARE REQUIRED! 
BLOCK 2 

29A/H2, 
NO 29A/E3 


TURN ON ‘ALL? 
IN RASFLGI 


MOVE NAME IN RETURN 
COMPARE BLOCK 2 


CVTNUM 29D/A2 


CONVERT AND 
TEST DOS 
REGISTER 


TURN OFF *ALL* 
IN RASFLGI 


START WITH 
"CR® 


MOVE NAME _ IN 
COMPARE BLOCK 2 


SUPPRESS CR RETURN 


CHARACTERS 
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Flowchart 29J. 


CLEAR CUU TABLE 


POINT TO FIRST 
AVAILABLE CUU 


CVTHEX 29D/A3 


CONVERT AND 
CHECK HEX 
ADDRESS 4 BYTES 


Fi 


[IS FIRST 
HALF BYTE 
ZERO 


YES 


MOVE CUU IN CUU 
TABLE 


SAVE ADDRESS OF 
LAST CUU USED 


RETURN 


MOVE SIO OPCODE 
IN OPCODE TABLE 


MOVE SSM OPCODE 
IN OPCODE TABLE 


NO 


TURN ON ‘'1/O* 


OPCODE TABLE 


Snap Subroutines (IIVRCP Part 9 of 14) 


FROM 
29A/He, 
29A/E3 


FROM 
29A/H2, 
29A/E3 


MOVE TIO OPCODE 
IN OPCODE TABLE 


MOVE TCH OPCODE 
IN OPCODE TABLE 


RETURN RETURN RETURN 


FROM CHART 
29A/H2, 29A/E3 


FROM CHART 
29A/H2e, 29A/E3 


MOVE ISK OPCODE 
IN OPCODE TABLE 


MOVE SSK OPCODE 
IN OPCODE TABLE 


RETURN RETURN 


RETURN 


FROM CHART 
29A,H2, 29A/E3 


FROM CHART 
29A/H2, 29A/E3 


TURN ‘ALL! 
'PC* SWITCHES, 
MOVE ALL 
OPCODES IN 
OPCODE TABLE 


IN RASNPS¥I. 
MOVE 1/0 
OPCODES IN 


RETURN RETURN 


FROM CHART 
29A/H2, 


FROM 
29A/H2, 
29A/E3 


MOVE _HIO OPCODE 
IN OPCODE TABLE 


RETURN 


FROM CHART 


29A/E3 29A/H2e, 29A/E3 


MOVE LPSW 
OPCODE IN 
OPCODE TABLE 


RETURN 
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Flowchart 29K. 


316 


STOINV OR 
STOILN 


MOVE DEFAULT 
EMBLK PLUS DOS 
IN STORGSW 


DEFAULT TO 50 
IN SNAP NUMBER 


RETURN 


MOVE ‘DOS* 
STORGSW 


RETURN 


DOS Emulator Logic 


29A/H2, 
29A/E3 


IN 


MOVE 


MOVE 


*EMBLK * 
STORGSW 


RETURN 


*‘NODOS'* 
STORGSW 


RETURN 


FROM 
29A/H2, 
29A/E3 


IN 


IN 


Storage Subroutines (IIVRCP Part 10 of 12) 


FROM 
29A/E3 


MOVE ‘EMU’ IN 
STORGSW 


RETURN 


CVTNUM 29D/A2 


CONVERT BINARY 
UP TO 2 BYTES 


ADD {| IN SNAP 
NUMBER 


STORE_SNAP 
NUMBER IN 
RASSNPNO 


RETURN 


29A/He, 


FROM 
29A/He, 
29A/E3 


MOVE ‘ALL* IN 
STORGSW 


RETURN 


Flowchart 29L. Diagnostic Subroutines ({IIVRCP Part 11 of 14) 


DIAGINIT 
OR 
DIA N A DIA : A 4 
ENTRY ENTRY 
FROM FROM 
e9A/Fi, 29A/H2,29A/E3 
29N/C5 


B4 


POINT TO FIRST 
DIAG BLOCK 


DIAG WITH A 
PARAMETER 


POINT TO FIRST 
COMTAB 


CYTHEX 29D/A3 
YES CLEAR RASCONS 


POINTER TO DIAG CONVERT DOS CUU 
BLOCK CHAIN 


LAST DIAG 


SAVE THIS DOS 
BLOCK DONE CUuU 


NO 


FLAG *DIAG 
WITHOUT A 
EA ROME TE BIT 


FREEMAIN THE RETURN 


POINT TO FIRST 
DIAG BLOCK DI 


AG BLOCK IN 
CHAIN 


E4 
POINT TO NEXT YES GETMAIN FOR NEW 
DIAG BLOCK IN DIAG BLOCK 
CHAIN 
NO 
POINT TO NEXT ATTACH IT TO 
ONE CHAIN 


MOVE DOS CUU IN 
DIAG 


HS 


FLAG 
"DIAG 
WITHOUT 
PARAMETER 
ON* 


POINT TO NEXT YES 


COMTAB 


NO 
J4 
& 
NO RETURN 
END OF COMTAB 
YES 
RETURN 
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Flowchart 29M. Exit Subroutines 
EXILINIT 
OR 
EX N A EX A 
ENTRY ENTRY 


FROM 29A/F1, 


FROM 29A/H2, 
29N/C5 


29A/E3 


LOCATE FIRST 
EXIT ADDRESS 


LOCATE SVC EXIT 


NO IS THERE AN 


ADDRESS 


DELETE 
CORRESPONDING 
MODULE 


CLEAR EXIT 
ADDRESS 


RESTORE DRILIST 
TO POINT TO 
TIVRTE 


POINT TO NEXT 
EXIT ADDRESS 


ORE SERVICE 
S FROM OLD 
IST ADDRESS 


H1 
YES 
RETURN 
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(TIVRCP Part 12 of 14) 


ENTRY ENTRY 


6 
ps 


FROM 29A/H2, 


29A/E3 29A/E3 


Li 


LOCATE PC EXIT 


LOCATE LEX EXIT 


CVTNUM 29D/A2 


GO CHECK VALID 
NUMBERS 


YES 


LOCATE 
CORRESPOND ING 
EXIT 


F3 


EXIT 
ALREADY 
ACTIVE 


DELETE 
CORRESPONDING 
MODULE 


SAVE NEW MODULE 
NAME 


LOAD NEW USER 
MODULE 


STORE EXIT 


ADDRESS 


RETURN 


FROM 29A/H2, 


ENTRY 


FROM 29A/H2, 
29A/E3 


LOCATE AS EXIT 


MOVE SERVICE 
AIDS ENTRY IN 


DRILIST 
OLD DR 


IL 


SAVE 
IST 


Flowchart 29N. End Subroutine {IIVRCP Part 13 of 14) 


ENDIN A 
ENTRY 
FROM 29A/F1 (3 ) (2) 
; : ENDO9 ¥ B3 
NO POINT TO NEXT 
SET 'END' FLAG LOAD IIVSCI 11VSC1 LOADED COMMAND IN 
CMDDICT 
YES 
C1 C3 
NOLWONLY | WORD NO 
RD 11VPCI LOADED LOAD IIVPCI GO RESET FOR 
THIS COMMAND 


D3 
NO SAVE DRIPCE END _OF 
T}1VACI LOADED MOVE IIVPCI IN CMOD ICT 
DRIPCE 
NO YES 
YES 


IN CA 
YES 
Dt 
ONLY { CARD 
IN STATEMENT 


END 10 El 


E5 
29P 
NO SAVE IIVRTE ADDRESS BI YES 
TRACE WANTED IN EMUCONS (ART20), DELETE IIVSCI IT¥SCI LOADED 
MOVE IIVACI INTO 
ART20 
NO 


YES 


RESTORE DRISVC. 
CLEAR SCI 


SAME VALUE 
IN [TIVRAS AND 
11 VRCP 


YES 


ENDO! Gi ENDO2 G2 


G5 
NO NO YES 
TRACE WANTED DELETE IIVYPCI I 1¥PCl LOADED 
NO 


YES © 


(S THERE AN 
EXISTING 
TRACE 


GETMAIN NEW 


RESTORE DRIPCE, 
CLEAR FCI 


FREEMAIN TRACE 
TABLE TRACE TABLE 


J5 
MOVE ADDRESS IN YES 
RASCONS, MOVE DELETE I1VACI 11VACI LOADED 
VALUE FROM RCP 

NO 


29Pp 
B3 


CLEAR TRACE 
TABLE ADDRESS 


RESTORE ADDRESS 
IN _EMUCONS 
Bale aoa 


SYMBOL TABLE 


INV _-- ROUTINES TO 


RESET EACH COMMAND 
(SEE cee FIGURE 
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Flowchart 29P. 


ENDLOAD Bl 


SAVE IILVCCW 
ADDRESS 


LOAD IIVRCW 


STORE THIS 
ADDRESS TO 
REPLACE I!IVCCW 


RETURN 
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NO 


11VRCW LOADED 


End Subroutine (IIVRCP Part 14 of 


29P 
C5 
FROM 


29N/K4, 
29N/J5 


1 1¥VRCW LOADED 


DELETE I IVRCW 


RESTORE IIVCCW 
ADDRESS 


RETURN 


14) 


Snap Dump and Trace Formatting Routine -{(Flowcharts 30A-308) 


Module name: TIVSNP 
Entry point name: LTIIVSNP 
Major functions: 


° Formats Emulator control blocks, trace tables, DOS main storage 
* Tssues OS snac macro (PDATA=ALL or SDATA=ALL) 


Entered by: 


° IITVRAS 
* TTVACT 
® TIVPCTI 
e TIvsct 


Modules called: None 
Exits to: 


e Caller 
2 I [LVABN 


OS macros issued: 
SAVE 

RETURN 

TIME 

SNAP 

WRITE 

CHECK 

DCBD 


*eett8te% 


Input: 


° Register 1 - option in effect message preceded by a 2-hyte Field 
{length minus one) 

Register 0 - nonzero indicates trace table snap only 

DOS storage 

RASCONS 

Emulator control hlocxs 


Output: Formatted snap ‘lump 
Return codes: None 
Tables/work areas: 


ITVCON (EMUCONS) 
IIVRCN (RASCONS) 
Local execution list 
NOS storage 

COMTAB 


Errors detected: Invalid FIDSLK chain while formatting Emulator 
I/O control blocks 


Messages requested: None 
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Flowchart 30A. 


RESET PAGE 
co 


UNT 
INITIALIZE LINE 
COUNT 


RAS15000 30H/AI 


PRINT HEADING 


UNPACK TIME_AND 


DATE, UPDATE 
PAGE COUNT 


RAS1I5000 30H/A1 


PRINT HEADING 


GET OPTION, 
UPDATE RDW, 


MOVE MESSAGE TO 
OUTPUT BUFFER 


RAS1(5000 30H/AI 


PRINT MESSAGE 


HI 


TRACE TABLE 
ONLY 


FORMAT EMULATOR 
TRACE TABLE 


EXIT 


1 VABN 
CHA 


l 
(CHART 26A)} 


Snap Dump and Trace Formatting Routine (LIVSNP Part 1 of 


FROM |1VRAS 
(CHARTS 28A, 
28B) LIVPCI 
(CHARTS 31A, 


31C) IIVSCI 
(CHART 32A} 
11VACI 
(CHARTS 33G, 


33H) 


RAS1I5000 30H/A\ 
PRINT _ INTERRUPT 
ADDRESS 


RASITOOO 30G/A4 


CONVERT ADJUST- 


MENT FACTOR TO 
EBCDIC 


RAS15000 30H/AI 


PRINT 
ADJUSTMENT 
FACTOR 


RAS!T000 30G/A4 


CONVERT LEX 
LIST AND INPUT 


TO EBCDIC 


RAS15000 30H/AI 


PRINT FIRST 
LINE OF LEX 
LIST 


MOVE DATA TO 
OUTPUT BUFFER 


SET UP RAS17000 30G/A4 


CONVERT REST OF 
LEX LIST TO 
EBCDIC 


NO INTERRUPT 


ADDRESS FOR 
CONVERSION 


RAS(5000 30H/AI 


PRINT REMAINDER 
OF LEX LIST 


RAS1T000 30G/A4 


CONVERT ADDRESS 
TO EBCDIC 


MOVE INTERRUPT 
ADDRESS TO 
SERVICE AIDS 
MESSAGE 


PRINT EMUCONS 


‘te 
RAS16000 30K/AI 
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=P. 
Ks 


RAS15000 30H/A{ 


PRINT MESSAGE 
EMULATOR 1|/O 
CONTROL BLOCKS 


GET NUMBER OF 
COMTAB_ ENTRIES 
AND ADDRESS OF 

COMTAB 


FROM 
30C/B1 D4 


Cie 


NO 


MOVE _IN ‘SYSEM’* 
IDENTIFIER 


RAS!7T000 30G/A4 


CONVERT BIN 
NUMBER TO 
EBCDIC 


CONCATENATE BIN 
NUMBER TO 


10) 


Flowchart 30R, 


Al 
FROM 30A/H4, 
30A/F4 


RA O14 A 


RASI7000 30G/A4 


CONVERT OOS CUU 
TO EBCDIC 


CONCATENATE CuUu 


TO *SYSEM* 


aa 
» 
CO 


GET CORRECT 


MOVE IN COMTAB FIDBLK CHAIN 


RASI6000 30K/AI 
PRINT COMTAB 


ANY MORE 
FIDBLKS 


NO 


YES 


m 


E2 


NO DOES THIS 
FID GO WITH 


CTEXT 


NO 


y, 


YES 


MOVE IN STGCON 


RAS16000 30K/AI 
PRINT 10B 


GET NEXT FIDBLK 
IN CHAIN 


J2 


GO BACK FOR 
NEXT FID 


YES 
MOVE IN CTEXT 


@ x< 
m xr 
wn —_ 


D3 


GONE 
THROUGH ISAM 


YES 


RESET F1IDSW 
AND GET 
ADDRESS OF 
ERROR MESSAGE 


RASI5000 30H/AI 


PRINT ERROR 
MESSAGE 


GET NEXT CTEXT 
IN CHAIN 


GET NEXT FIDBLK 


NO 


Snap Dump and Trace Formatting Routine 


IN [OB 


MOVE IN LOGIOB 
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Flowchart 30C. 


@ FI 


324 


FROM 30B/HI 


GET NEXT COMTAB 


Bl 


1S THERE 
ANOTHER 
COMT AB 


YES] 30A 
D4 


NO 


GET OPERATION 
POINTER 


D3 


HAS 
INSTRUCTION NO 
BEEN 


SIMULATED 


1/0 INTERRUPT 
NO 


RAS{4000 30E/Alt 
SNAP TRACE YES 


TABLE SNAP TRACE 
TABLE 


G3 
MOVE_DOSREGS YES 
0-7 TO OUTPUT 

BUFFER 


SET FLAG FOR 


SKIP TQ, EHANNED MOVE IN ‘BEBLK* 


Jt 


RAS16000 30K/AI 


PRINT BEBLK 


SNAP_ALL 
DOS STORAGE 


YES 


RASI7T000 30G/A4 


CONVERT TO 
EBCDIC 


RESET TO TRIPLE GET ADDRESS AND 
SPACE 


LENGTH OF 
DOSREGS 0-7 


DOS Emulator Logic 


SET FLAG TO 
FORMAT 
REGISTERS 


Snap Dump and Trace Formatting Routine (IIVSNP Part 3 of 10) 


ANY MORE 
BEBLK ENTRIES 


GET BEGINNING 
AND ENDING 
ADDRESS OF CCW 
STRING 


RAS16000 30K/Al 


PRINT CCW 
STRING 


GET NEXT BEBLK 
ENTRY 


ts 


RAS18000 30J/A3 
FORMAT 
REGISTERS . 


Flowchart 30D. Snap Dump and Trace Pormatting Routine {IIVSNP Part 4 of 10) 


y 


FROM 30C/K5 


RA515000 30H/AI 


PRINT DOS 
REGISTERS 


DOs 
REGISTERS 
8-15 PRINTED 


NO 


YES 


GET LENGTH AND 
MESSAGE FOR DOS 


PERMANENT 
STORAGE 


SNAP PDATA=ALL RETURN 


D1 


SNAP_ALL 
DOS STORAGE 


NO 


GET _ MESSAGE AND 
SIZE_FOR DOS 
STORAGE 


SNAP SDATA=ALL 


RAS15000 30H/AI 


PRINT MESSAGE 


GET SIZE AND 


ADDRESS OF DOS 
STORAGE 


RAS!6000 30K/AI 


PRINT ADJUSTED AND 
LOCAL ADDRESSES OF 
DOS STORAGE 


RAS15000 30H/A1 RAS15200 30J/AI (cs) 


PRINT MESSAGE EMPTY BUFFER 
END OF DUMP 
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Flowchart 30E. 


RAS 


FROM 30A/ 1, 
30C/Fe 


Bi 


ANY ACTIVE 
ENTRIES 


YES 


RAS15000 30H/AI 


PRINT TRACE 
TABLE HEADER 


ADDRESS OF 
MOST RECENT 
ENTRY 


GET 


WRAP AROUND 


RE INITIALIZE 
REGISTER WITH 
NUMBER OF 
ACTIVE ENTRIES 


FROM 30F/Je2 
30F /F 1 


POINT TO ENTRY 


RAS1T000 30G/A4 


CONVERT ENTRY 
TO EBCDIC 


PUT 
IDENTIFIER 


INTERRUPT 
IN 


OUTPUT BUFFER 
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Trace Table Subroutine ({IIVSNP Part 5 of 10) 


NO 


RETURN 


ELAT 
INSTRUCTION 


MOVE INTERRUPT 
PSW_TO OUTPUT 
BUFFER 


D3 


NO 


YES 


E3 


YES MOVE BTR TO 


OUTPUT BUFFER 


MOVE LDMD TO 
OUTPUT BUFFER 


MOVE NAME TO 
OUTPUT BUFFER 


xy 


F 


J4 


DID 
EMULATOR 
SIMULATE SVC 


MOVE RO AND Ri, 


SVC _ NUMBER TO 
OUTPUT BUFFER 


pOS Emulator Logic 


ROM 30F/0D3, 
30F/G5 


MOVE RESUME PSW 


Flowchart 30F. 


FROM 
30E/D3 
FROM 
RAS14125 Al 30G/Cl, A2 
30G/A3 
YES NO MOVE CSW TO 


OUTPUT BUFFER 


MOVE SENSE TO 
OUTPUT BUFFER 


c3 
MOVE KEY AND NO 
ADDRESS TO 

OUTPUT BUFFER 
FROM 
30E/J4, YES 
3Z0E/J5 
RA 0 r) 


ZERO ROW, MOVE 


LRECL AND DATA MOVE ID TO 


ADDRESS TO OUTPUT BUFFER 


OUTPUT BUFFER 


RAS15000 30H/AI 


PRINT RECORD 


Fi 


YES ANY MORE 


ENTRIES RESET POINTERS 


NO 


GI 


SECOND TIME 


WRAP AROUND THROUGH 


MOVE _ TRACE 
COMPLETE 
MESSAGE TO 
OUTPUT BUFFER 


GET MOST RECENT 
ENTRY, ADJUST 
TABLE ADDRESS 


RASI5000 30H/AI 


PRINT MESSAGE 


GET NUMGER OF 
ACTIVE ENTRIES 
TO BE PROCESSED 

AND FORMATTED 


RETURN 


SYMBOL TABLE 


RDW - RECORD 


DESCRIPTOR WORD 


Trace Table Subroutine (TIVSNP Part 65 of 10) 


C4 


YES 


y 


z 
a) 


oO 
> 


YES 


y 


z 
Oo 


m 
b 


YES MOVE CUU TO 


OUTPUT BUFFER 


, 


z 
) 


n 
> 


F5 


YES YES 


y 


z 
o 


oO 
- 


YES MOVE Reeve PSW 


y 


z 
o 


<= 
> 


( 


YES 


Cc 
- 


NO 


pS 


ra) 


MOVE MBBCCHHR, 
SEEK _ID TO 
OUTPUT BUFFER 
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Flowchart 30G. Trace Table and EBCDIC Conversion Subroutines (IIVSNP Part 7 of 10) 


FROM 30F/J4, 
30F/K4 


RAS14228 Al 


IS S10 CC 
CSW STORED 


MOVE CCW OP 
CODE TO OUTPUT 
BUFFER 


WWWWWWT 
foleloleleleP!! 
AKAODY YO 
ST 


MOVE AND READY 
BYTES TO BE 
TRANSLATED TO 
OUTPUT BUFFER 


MOVE CAW TO 
OUTPUT BUFFER 


MOVE 1D AND CCW TEXT TO BE 
TO OUTPUT TRANSLATED 
BUFFER 


TRANSLATE TO 
EBCDIC 


RETURN 
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Flowchart 30H. Write Subroutines (IIVSNP Part 8 of 10) 


RAS15000 
FROM 30A/CI 
Z30A/E1, 30A/GI, 
ENTRY 30A/B83, 30A/D3, 
30A/F3. 30A/J3, 
30A/B4, 30B/F3, 
30C/F3, 30D/Al, 
30D/Fl, 30D/u!; 
30E/C1, 30F/E1, 
30F/H1; 30K/D3, 
30K/K5 
GET LOGICAL AND 
PHYSICAL RECORD 
LENGTHS 
ro c2 C4 
ADJUST LINE 
WILL RECORD\. YES SKIP TO COUNT ACCORD ING NO UPDATE LINE 
FIT 1N OUTPUT CHANNEL ONE TO ASA RESTORE PAGE COUNT 


8) 
BUFFER CHARACTER 


NO YES 


D2 D3 
D 
RAS1I5200 30J/AI 
NO HAVE WE 
WRITE OUT BLOCK 


ALREADY 
RESTORED 


NO GET PHYSICAL 
AND HEADER 
RECORD LENGTH 


YES 
E4 
LOAD OUTPUT WILL HEADER “YES 
BUFFER, UPDATE RECORD FIT IN 
Bpw BUFFER 
F2 F3 


NO RAS(5200 30J/A1 


WRITE OUT SLOCK 


sKIP_TO 


CHANNEL 1 


rg 


LS SYSSNAP CHANGE LINE 
UNIT-RECORD SPACING TO 
DEVICE SINGLE SPACE 


NO BUILD HEADER 


RECORD _ IN 
BUFFER 


RAS15200 30J/AI 


RE INITIALIZE 
WRITE OUT LINE COUNT 
RECORD 


J2 


BLANK _ INPUT NO . 
BUFFER 


y 
: RAS15200 30J/A1 


BLANK QUT INPUT 
BUFFER RETURN WRITE OUT 
RECORD 
SYMBOL TABLE 


BOW- BLOCK 


DESCRIPTOR WORD 


Program Organization 329 


Flowchart 303. Write and Data Formatting Subroutines {TIVSNP Part 9 of 10) 


RAS15200 RAS18000 


FROM 30C/K5, 
30K/B3 


GET DCB 

ADDRESS, SET 

BLKSIZE IN DcB, 
WRITE BLOCK 


INITIALIZE TO 
FORMAT DOS 
REGISTERS 


UPDATE BDW, PUT 
LOGICAL AND 
PHYSICAL RECORD 
LENGTH IN DCB 


FORMAT DATA_IN 
OUTPUT BUFFER 


RETURN 


RETURN 
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Flowchart 30K. Snap Subroutine 


GET STORAGE 
ADDRESS AND 
LENGTH 


RAS17000 30G/A4 


CONVERT TO 
EBCDIC 


Dt 


MOVE 
DISPLACEMENT TO 
OUTPUT BUFFER 


PRINT 
DISPLACEMENT 


MOVE IN LOCAL 
ADDRESS TO 
OUTPUT BUFFER 


PRINT LOCAL 
ADDRESS 


GET ADORESS OF 
DATA AND LENGTH 


RASI7T000 30G/A4 


CONVERT TO 
EBCDIC 


HI 


(IIVSNP Part 10 of 10) 


GET STARTING 
DATA ADDRESS 


RAS18000 30J/A3 


FORMAT BUFFER 


GET RECORD 
ADDRESS AND 


LOGICAL RECORD 
LENGTH 


Db 
RAS!5000 30H/AI 


PRINT RECORD 


YES 
GET NEXT LINE 
<< 
YES 
GET 


ADDRESS AND 
LENGTH 


RETURN 


INPUT AREA 


YES 


CAN LINE BE 
FLILLEO 


RAS17T000 30G/A4 


SET NEXT 
ADDRESS UP FOR 
CONVERSION 


NO 


USE NUMBER OF 


BYTES LEFT 


KI 


IS DATA TO 
BE SHIFTED 
LEFT 


CONVERT TO 
EBCDIC 


J4 


LINE SAME SAME 
MESSAGE SET UP 
WITH ADDRESS 


LINE OR 
LINES SAME 
MESSAGE 


LINES SAME 


i’ 


RAS1!5000 30H/AI 


PRINT RECORD 


LINES SAME 
MESSAGE WITH 


© 


BEGINNING AND 
ENDING 
ADDRESSES GIVEN 
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Program Check Intercept Routine (Flowcharts 31A-31C) 


Module name: IIVPCcrI 
Entry point name: IIVPCI 
Major functions: 


» Trace and snap privileged operations 
° Give control to a program check user exit if specified 


Entered by: IIVRAS 
Modules called: 


« LIVSNP 
® ITVRASnn (program check user exit routine) 


Exits to: JIIVPCE 
OS macros issued: None 
Input: 


e Fields in TIVRCN (RASCONS) 
° DOS storage 


Output: Fields in IIVRCN (RASCONS) 
Return codes: None 

Tables/work areas: 

TIVRCN (RASCONS) 

TIVCON (EMUCONS) 


Local execution list 
DOS storage 


en oe oe 


Errors detected: None 


Messages requested: None 
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Flowchart 31A. Program Check Intercept Routine ({IIVPCI Part 1 of 3) 


FROM _IIVYRAS 
(CHART 28B) 


Bl 


I1VSNP 30A/AlI 


SNAP EMULATOR 
CONTROL BLOCKS 


PRIVILEGED 
OPERATION 


NO 


SWAP _ INTERRUPT 
ADDRESSES AGAIN 


01 


NO 
SNAP FOR PC uy 


YES 


Et 


IS_1T STILL NO 
IPL 


DOS 


BYPASS IPL 
SNAPS 


SWAP 
INTERRUPTION 
ADDRESSES FOR 

SNAP 


Ht 


SNAP COUNT ES 
EXHAUSTED 


NO 


UPDATE NUMBER 
OF SNAPS 
REMAINING 
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Flowchart 31B. 


334 


PCE500 


PRIVILEGED 
OPERATION 


EMULATOR 
SUPPORTED 
OPERATION 


SNAP FOR PC 


i 
STILL 


DOS 


IN TPL 


BYPASS SNAP 
DUMPS FOR IPL 


DOS Emulator Logic 


Program Check Intercept Routine (IIVPCI Part 


A3 


DO WE TRACE NO 
THIS 


OPERATION 


YES 


B3 


INPUT / OUTPUT 
RELATED OPERATION 


NO 


GET CUU FROM 
INSTRUCTION 
BDDD 


WAS CUU 
SPECIFIED 


DO WE TRACE 
FOR THIS CUU 


POINT TO NEXT 
AVAILABLE TRACE 
TABLE ENTRY 


INITIAL! ZE 
ENTRY TO ZERO 


MOVE IN LEX PSW 
CUuU AND 
INTERRUPT CODE 


INDICATE TRACE 
TO BE COMPLETED 


2 of 3) 


Flowchart 31C. 


FROM 31A/Ct, 
31B/J3 


PCE550 Al 


SNAP FOR 
THIS 
OPERATION 


NO 


YES 


~ 
ons 


SET UP 
OPTION _IN 
EFFECT (CAUSE 
OF SNAP) 


Ci 


1/O RELATED 
OPERATION 


GET CUU FROM 
INSTRUCTION 
BDDD 


WAS CUU 
SPECIFIED 


DO WE SNAP 
FOR THIS CUuU 


CONVERT CUU 
To EBCcDIC 


MOVE CUU TO 
OPTION MESSAGE 


SWAP_ INTERRUPT 
ADDRESSES 


PCE925 


PC USER 
EXIT 
SPECIFIED 


LIVYRASNN 


PC USER EXIT 
ROUT INE 


OPTIONAL 
SNAP _DUMP 
REQUESTED 


SET UP OPTION 
IN EFFECT 
MESSAGE 


SWAP_ INTERRUPT 
ADDRESSES 


LIVSNP 3OA/At 


SNAP EMULATOR 
CONTROL BLOCKS 


SWAP_ INTERRUPT 
ADDRESSES AGAIN 


TO LIVPCE (CHART 8A) 


Program Check Intercept Routine {IIVPCI Part 3 of 3) 
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Supervisor Call Intercept Routine (Flowchart 32A) 


Module name: TIIVSCT 

Entry point name: TJTIVSCI 

Major functions: 

e Intercepts DOS supervisor call when TRACE=SVC or SNA ?=SVC=nn 
is specified 

° Gives control to user exit routines 

Entered by: ITIVRAS 

Modules called: 


e TIVSNP 
e IIVRASnn (supervisor call user exit routine) 


Exits to: IIVSVC 
OS macros issued: None 
Tnputs: 


° Fields in TIVRCN (RASCONS 
@ DOS storage 


Output: Fields in TIVRCN (RASCONS) 
Return codes: None 

Tables/work areas: 

IIVRCN (RASCONS) 

IIVCON (EMUCONS) 


Local execution list 
DOS storage 


Errors detected: None 


Messages reauested: None 
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Flowchart 32A. 


1iVSCI 
ENTRY 


FROM _IIVRAS 
(CHART 28B) 


GET POINTER TO 
SVC _ CHAIN AND 
SVC NUMBER 


END_OF SVC 
TABLE 


YES 


NO 


Di 


MATCH SVC 
NUMBER FROM 
TABLE 


NO 


YES 


MOVE SVC NUMBER 
INTO OPTION IN 
EFFECT MESSAGE 


MODULE NAME NO 


SPECIFIED 
(a1) YES 
GI 


MODULE YES 
NAMES EQUAL 


NO 


INCREMENT 
POINTER TO NEXT 


MODULE NAME IN 
TABLE 


Jt 


ANY MODULE 
NAMES LEFT 


NO 


NO 


1S _ TRACE 
SVC SPECIFIED 


YES 


SVC00100 


MOVE SVC NUMBER, 
SVC_INTERRUPT, OLD 


1S_ TRACE 
ALL SPECIFIED PSW, DOS RO, Ri 


INTO TRACE TABLE 


GET POINTER TO 


NEXT SVC IN 
TABLE 


Fe 


IS SNAP 
COUNT 
EXHAUSTED 


NO SWAP INTERRUPT 


ADDRESSES 


MOVE MODULE 
NAME FOR SNAP 
DUMP 


Supervisor Call Intercept Routine (ITVSCTI) 


MOVE DOS MODULE 
NAME INTO TRACE 
TABLE 


SET TRACE NOT 


c4 
YES 
<a> COMPLETE FLAG 
D5 
<> WAS USER NO 
NO 


EXIT ROUTINE 
SPECIFIED 


I TVRASNN 


GO TO USER EXIT 
ROUT INE 


IIVSNP 30A/Al1 


GET LENGTH OF 
MESSAGE AND SNAP 
EMULATOR CONTROL 

BLOCKS 


OPTIONAL 
SNAP DUMP 


SWAP _ INTERRUPT 
ADDRESSES AGAIN 


SWAP_ INTERRUPT 
ADDRESSES 


11VSNP 30A/A1 


SNAP EMULATOR 
CONTROL BLOCKS 


SWAP_ INTERRUPT 
ADDRESSES AGAIN 


EXIT 


TO 1TIVSVC (CHART 17A) 
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Asynchronous Intercept Routine (Flowcharts 33A-33H) 


Module name: IIVACI 
Entry point name: JIIVACT 
Major functions: 


PSW compare 

Trace entry completion 

Second snap for privileged operations 

Local execution exit routine 

Check for asynchronous interruptions (trace and snap) 
Sive control to user exit routines 


Entered by: 


Entry point address placed in EMUCONS (ART20 by IIVRCP) 
TIVPCE 
TIVLOG 
ITIVRTE 
IIVSTG 
ITVRAS 


Modules called: 


e TIVSNP 
e TIVRASnn (local execution user exit routine) 


Exits to: IIVRTE 

OS macros issued: None 

Input: 

e Fields in module TIVRCN (RASCONS) 

e COMTAB 

e DOS storage 

Output: Fields in module IIVRCN (RASCONS) 


Return codes: None 


Tables/work areas: 


e TIVRCN (RASCONS) 

e EMUCONS 

° Local execution list 
e COMTAB 

6 


DOS storage 
Errors detected: None 


Messages requested: None 
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Flowchart 33A. 


LIVACI 


IS TRACE 
INCOMPLETE 


ZERO RPSW FIELD 


svc 
SIMULATED BY 
EMULATOR 


MOVE IN RESUME 
PSW (RPSW) 


Asynchronous Intercept Routine (IIVACT Part 1 of 8B) 


63 


YES MOVE IN KEY AND 


STORAGE ADDRESS 


NO 


MOVE IN RESUME 


PSW (RPSW) 


D3 
L} & 
YES 
MOVE IN CSW 
E3 
NO 
YES 


SEARCH COMTAB 
CHAIN FOR 
MATCHING CUU 


YES 
COMTAB FOUND 


ANY MORE 
COMTABS 


NO 
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Flowchart 33B. Asynchronous Intercept Routine (TIVACI Part 2 of 8) 


FROM 33A/F1 
33A/B4, 33A}E3, 
33A/H3, 33A/G 
33C/G3 


FROM 33A/G3 


RTER2060 Al 


RESET TRACE 
INCOMPLETE 
SWITCH 


NO 


UPDATE TRACE 
TABLE POINTERS 


INDICATE SEEK 


AND MOVE _ IN 
MBBCCHHR 


on | 
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ASYNCHRONOUS 
INTERRUPTION BEEN 
CHECKED 


DOS DEVICE 
STAGED OR 
SYSLOG 


YES 


RESET 
ASYNCHRONOUS 
ALREADY CHECKED 
FLAG 


USE CAW FROM 
DOS MAIN 
STORAGE 


STAND- ALONE 
SEEK OR SENSE 


USE CAW FROM 
COMTAB (COMCAW) 


Fi F2 


CSW STORED 
IN LEX PSW 


YES NO 


MOVE CCW OP 
CODE AND_1IOB 
SENSE BYTES TO 
TRACE TABLE 


MOVE CAW AND 
FIRST CCW TO 
TRACE TABLE 
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Flowchart 33C. 


Asynchronous Intercept Routine ({IIVACI Part 3 of 8) 


FROM 33A/CI, (43) 
338/C3 


A3 


RTER2Z110 Al 


[/O INTERRUPT 


YES 


MOVE 1/0 CODE 


TO TRACE TABLE 


Cl 


ATTENT10ON 
BIT SET IN 
CSW 


NO 


WAS CUU 
SPECIFIED 


NO 


1S THERE A 
CUU MATCH 


POINT TO 
CURRENT TRACE 
ENTRY 


MOVE TYPE OF 
INTERRUPT TO 
TRACE TABLE 


E3 


YES YES 


MOVE CUU MOVE DOS 
INTERRUPT péw, EXTERNAL OLD 
AND CSW TO 


PSW TO TRACE 
TRACE TABLE TABLE 


SET 
ASYNCHRONOUS 


INTERRUPTION 
INDICATOR 
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Flowchart 33D. Asynchronous Intercept Routine (ITVACT Part 4 of 8) 


y 


RTER2135 Al 


FROM 33C/AI 


ay 


EXTERNAL 
INTERRUPT 


YES 


Bt 


TIMER 
INTERRUPT 


INDICATE TIMER INDICATE 
INTERRUPT EXTERNAL 
INTERRUPT 


DI 
YES 


DO WE TRACE 


GD LG 


NO 


y 
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Flowchart 33E. Asynchronous Intercept Routine (TIVACI Part 5 of 8) 


RTER2200 Al 


SD 
NO 


Bi B2 


VALID ADDRESS 


PSW OPTION 
REQUESTED 


YES ARE PSW 


S YES 
FIELDS EQUAL 


EQUAL COMPARE 


PSWH=XXXXXXXX 


NO 


cl 


COMP ARE NO SNAP COUNT 
OPTION EXHAUSTED 
REQUESTED 
YES 
DI 
i. 
GET ADORESS 
YES FROM DOS DECREMENT 
REGISTER SAVE NUMBER OF 
AREA REMAINING SNAPS 
NO 
E! 


GET ADDRESS 
FROM I IVRCN 


NO COMP =AXXXXXX 


ARE 


YES 
EQUAL COMPARE 


ANY MORE 
COMPARES 


NO 
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Flowchart 33F. Asynchronous Tntercept Routine {IIVACI Part 6 of 8) 


OU 33E/CI 


33E/G1, 33E/C4 


RTER2300 At 


a MOVE CUU TO 
SNAP FOR ATTN OPTION MESSAGE 


iy : 
OPTION_IN 


SET UP OPTION 
IN EFFECT *1/0 
INT® 


Cc 
*ATTENTION' 


E4 


NO 
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Flowchart 33G. Asynchronous Intercept Routine (IIVACI Part 7 of 8) 


RTER2315 


SWAP_ INTERRUPT 
ADDRESSES 


SNAP COUNT 
EXHAUSTED 


DECREMENT 
NUMBER OF 
REMAINING SNAPS 


}1VSNP 30A/AI 


SNAP EMULATOR 
CONTROL BLOCKS 


SWAP_ INTERRUPT 
ADDRESSES AGAIN 


INTERRUPT 1ON 


TIMER 
INTERRUPT ION 


33F/A1 


OPTION_IN 
EFFECT 

“EXTERNAL 
INTERRUPT ION® 
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Flowchart 33H. Asynchronous Intercept Routine (IIVACYI Part 8 of 3) 


FROM 33F/C3 

33F/F4, 33G/E1, 

33G/A3, 33G/E4 
RTER2999 ¥ AI 


LEX USER 
EXIT 
REQUESTED 


1 |IVRASNN 


LEX USER EXIT 
ROUTINE 


OPTIONAL 
SNAP DUMP 


SET UP OPTION 
IN EFFECT 
MESSAGE 


SWAP 
INTERRUPTION 
ADDRESSES 


II1VSNP 30A/A1 


SNAP EMULATOR 
CONTROL BLOCKS 


SWAP 
INTERRUPTION 
ADDRESSES AGAIN 


LIVRTE AT 
RUERE (CHART 
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Service Aids Adjust CCW Data Address Routine (Flowcharts 34A-34H) 
TIVRCW 


Module name: 
Cc Entry point name? 


Major functions: 


TIVRCW, RCCWAB4 


° Adjusts data addresses in a string of CCWs before being passed to OS for 
an I/0 operation and after completion of the CCW function in OS 


° The CCW's are adjusted in the DIAG block built by IIVRCP when the DIAG 


feature is 


Entered by: 


Modules called: 


® 
» 


ITTVPCE 
TIVCHK 
ITVRTE 


TIVADS 
TIVMSG 


Exits to: 


* 
*» 
Ld 


OS macros issued: 


ITIVPCE 
TI VCHK 
Caller 


Tnput: 


Adjustment 
Pointer to 
Pointer to 
Pointer to 
Pointer to 


called 


None 


factor 

a CCW string 

the local execution list 
the Emulator constants area 
COMTAB 


(IIVCON) 


eée#s#éese 


Local limit address 


Output: Adjusted CCW string 


Return codes: 


e Error code 16 for TIVABN 
* Error code 20 for TIVABN 


Tables/work areas: 


Adjust CCW data address list (located in ITVCON) 

BEBLK CCW addresses for adjusting 

Status modifier table used to find status modifier-type CCWs 
RCCWSAVE register Save area 

DIAG block 


eoe86 6 @ 


Errors detected: 


° BEBLK is filled and CCW adjusting cannot proceed 
. Adjusted addresses not within DOS storage area 


Messages requested: 


e IIVv2s801I 
i e IIv28iI 
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Flowchart 34A. 


FROM 
FROM LI1VPCE 34B/G4, 
{CHART 8M) 34B/H4, 
ITVCHK (CHART 34G/D2, 
9B) 34G/B3, 
34G/E3 


we 
= 


POINT TO FIRST 


MOVE CCW 
DIAG BLOCK 


ADDRESS FROM 
LIST TO BEBLK 


FROM 
34C/Fe, 
34G/B5 


SET_RETURN 
FOR STAE RETRY 
ROUT INE 


LAST DIAG 
BLOCK 
PROCESSED 


YES SAVE CCW 
ADDRESS FROM 
LIST 


SET ADJUST 
YES NO 


SWITCHES TO 


SET LIST 
OPERATION 


NT TO NEXT 


l SET FIRST- 
IAG BLOCK 


CCW-A-TIC 
SWITCH ON 


PO 
D 


Fe 


SAVE ACTUAL YES 
ADJUSTMENT 
FACTOR 


POSITIVE 
ADJUSTMENT 
FACTOR 


SET ABEND 
Bune eer en 


NO 
G2 G3 
IIVADJ {t6A/A2 
ADJUST LIST IS DIAG NO 
ADJUST CCW DATA 


LIMIT ADDRESS ACTIVE 


YES (s3 ) 


ADDRESS ROUTINE 


<> 


ISSUE ADJUST 
CCW STRING 
INSTRUCT 10N 


SET LIST 
ADJUSTMENT 
FACTOR TO 0 


SAVE DIAG BLOCK 
ADDRESS 


RCCWO5B J3 


SET CURRENT 
POINTER TO 
START OF BEBLK 


SET DIAG CC=! 
FEATURE ON 


CONDITION 
CODE 


s CC=2 AND 3 34B 

Bl 

RCCWAB K3 K4 
K3, 
B3, 
El 


cc=0 


CONDITION YES SLI BIT ON 
CODE=2 IN LAST CCW 
ADJUSTED 


ZERO OUT BEBLK 34E/ 


NO 
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34B/Fe, 
34F /J2 


Service Aids Adjust CCW Data Address Routine (IIVRCW Part 1 of 


SET ERROR 
CODE TO 16 


RCCWAB/ 


IS 
ADJUSTMENT 
FACTOR 0 


TURN OFF ABEND 
BYPASS SWITCH; 

RESTORE 
REGISTERS 


RETURN 


1S_THIS 


ACTUAL 
ADJUSTMENT OF 
ccw's 


LAST CCW 
ADJUSTED A 
Tic 


LAST CCW 
ADJUSTED END 
OF STRING 


SYMBOL TABLE 


LIST-ADJUST CCW 
DATA ADDRESS 
LIST 
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34B 
Bis FROM 34A/J3, 


O 
34A/H5 (3 ) 


ZERO OUT 
STATUS MODIFIER 
COUNTER 


) 
oO 
Ld 
G 
at 
wD 
ie) 
C2 
0 
0 


SET COMPLETE 
BIT _ON_IN BEBLK; 
TURN OFF ABEND 
BYPASS SWITCH 


c3 


MOVE CCW 
POINTER ADDRESS 


WAS LAST 
CCW DATA 
CHA INED 


NO 


FROM LIST TO 
BEBLK 


YES 


DI 


PUT DATA 
CHAINING 


ONLY ENTRY 
IN BEBLK 


UPDATE BEBLK 
POINTER COMMAND CODE IN 
LIST OPERATION 


BYTE 


RCCWI2 E3 


RCCwOos 
COMBINE 34H/A2 


COMBINE ROUTINE 


RCCWOBA Fi 


YES 
1S BEBLK FULL 
NO 


RCCWO8B GI 


DASD-TYPE 
DEVICE 


NO 


SET CODE FOR 
ABEND ERROR 
ROUTINE 20 


YES COMMAND 


x '9e2° 


coD 


LAST 


1S COMBINE YES CCw STATUS YES 
SWITCH ON MODIFIER TYPE 
NO 
H2 RCCWI3A ¥ H3 
TAPE OCR NO No JNO STATUS 
OR DASD TYPE MODIFIER >I 
DEVICE 
YES No 
Rccwosc ¥ JI 
PASS ADDRESS OF 
TAPE-TYPE YES YES 


DEVICE 


RING 
CALLING ROUTINE 


NO 


Service Aids Adjust CCW Data Address Routine (TIVRCW Part 2 of 8) 


SUBTRACT | FROM 
STATUS MODIFIER 
COUNTER 


POINT TO NEXT 
PREVIOUS CCW 


SET STATUS 
MODIFIER 
COUNTER TO 2 


SYMBOL TABLE 


LIST --_ ADJUST 


CCW DATA 
ADDRESS LIST 


RCCW13B G4 


STATUS 
MODIFIER 
COUNTER >f 


NO 


ADD 8 TO LIST 


CCW POINTER 


34A 
B3 
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Flowchart 34c. 


Be 


COMPLETE BIT ON 
IN ALL BEBLK 
ENTRIES 


YES 


SET COMBINE 
SWITCH OFF 


NO 


MOVE INCOMPLETE 


BEBLK ENTRY TO 


SET FIRST 
CCw-A-TIC 


CURRENT BEBLK 
SWITCH OFF ENTRY 


MOVE CCW 
ADDRESS FROM 
BEBLK_ TO LIST 

ccw POINTER 


MOVE OPERATION 
BYTE AND 
OPERATION 

POINTER FROM 
BEBLK TO LIST 


ADD & TO 
INCOMPLETE 
BEBLK ENTRY 

POINTER 


SYMBOL TABLE 


LIST --_ ADJUST CCW 
DATA ADDRESS LIST 


ue? 


350 DOS Emulator Logic 


Service Aids Adjust 


CCW Data Address Routine (IIVRCW Part 3 of 


FROM STAE 
RETRY ROUTINE 
IN LIVRTE 
(CHART 20C), 
ALSO 34D/K4 


FROM 34D/C5, 
34E/D3 


RC 


SET CURRENT RESTORE 
POINTER TO REGISTERS; TURN SET ERROR 
BEBLK BEGINNING OFF ABEND CODE TO 16 


ADDRESS +8 BYPASS SWITCH 


PUT ACTUAL 
RELOCATION 
FACTOR IN LIST 


RETURN 


TO LIVPCE (CHART 
8M) OR IIVCHK 
(CHART 3B) 


READJUST 


L 
ADDRESS IN 


E3 


RESTORE 
DIAGNOSE BLOCK 
ADDRESS 


DIAGNOSE 
FEATURE 
ACTIVE 


YES POINT TO FIRST 
BEBLK 


NO 


ROM 
34D/F2 


MOVE CCW 
ADDRESS FROM 
BEBLK TO LIST 

CCW POINTER 


POINT TO BUFFER 
IN DIAGNOSE 
BLOCK 


34D 
RC¢Y Bi 
SET ABEND 
BYPASS SWITCH 
H3 
I IVADJ 16A/A2 
YES 
ADJUST CCW DATA 
ADDRESS ROUTINE 
J5 


ISSUE ADJUST 
CCW STRING 
INSTRUCTION; 

SET ABEND 
BYPASS SWITCH 


YES 


LAST BEBLK 
ENTRY 


ROM 34A/F5 
RCCWITA, K4 


? OR 


RCCWI7C K3 


LAST 
CCW POINTER 
< BEBLK END 
ADDRESS 


CONDITION NO 
CODE 


ADD & TO 
CURRENT POINTER 


YES 


r#e 
jor, 
op) 


Flowchart 34D. Service A’ Adjust CCW Data Address Routine (IIVRCW Part 4 of 8B) 


B2 B3 


COMPUTE 
YES YES CORRESPOND ING 
ERROR DOS ADDRESS AND 
STORE IN JOBCSW 


STORE ADD_OF 
BUFFER IN BEBLK 
ENTRY 


NO 
C3 
COMPUTE LENGTH 
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PROGRAM_AS CCW STRING TIc FLAG IN 
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BEBLK 


INSTRUCTION DIAGNOSE 


IIVADJ 16A/A2 


ADJUST CCW DATA 
ADDRESS ROUTINE 


LOCATE ADDRESS 
GIVEN BY TIC IN 
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BUFFERS 


ADD_THIS_ LENGTH 
TO BUFFER 
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RECWD29 
11YVMSG 27A/A1 


SPACE LEFT NO CORRESPONDING 
IN DIAGNOSE ISSUES MESSAGE DOS TIC ADDRESS 
BLOCK LIv28t1 AND STORE IN 

ccw 
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MOVE X‘tFF* IN YES MOVE CCW'S 
LAST BEBLK DIAGNOSE CUU IN BEBLK 


ANY COMPUTE 
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RCCWD26 G3 


JIVMSG 27A/A1 


POINT TO FIRST CCW IN DOS= NO 
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YES 
Ht H3 
RELOCATE NO YES ANY OTHER STORE DOS 
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YES NO 
EXCHANGE ALL 
IN BUFFER RESTORE IOBCAW 
IN TO DOS START 
DOS BEBLK ADDRESS 
Ly EN 
SET ABEND LOOK FOR jJoOsCSW RESTORE ACTIVE 
BYPASS SWITCH ADDRESS _JN ONE FLAG IN 
ON OF THE BUFFERS DIAGNOSE 
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Flowchart 34E. Service Aids Adjust CCW Data Address Routine (IIVRCW Part 5 of 8) 
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Flowchart 34F. Service Aids Adjust 


FROM 34A/J3, 
34A/G5 


SET COMPLETE 
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BYPASS SWITCH 
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LIST TO BEBLK 


DI 
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ADD 8 TO BEBLK 
POINTER 


COMBO4A 34H/A4 


COMBINE ROUTINE 
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YES 
BEBLK FULL 
NO 


SET CODE FOR 
ABEND ERROR 
ROUTINE 20 


SYMBOL TABLE 


LIST -_ ADJUST 
CCW DATA 
ADDRESS LIST 


CCW Data Address Routine (IIVRCW Part 6 


RCCW20A B4 


1S COMBINE 
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8) 


Flowchart 34G. 


34F /J4 
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INCOMPLETE 
ENTRY IN 
BEBLK 
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ENTRIES POINTER 


MOVE BEBLK 
CURRENT START 
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UPDATE 
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SYMBOL TABLE 
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CCW DATA 
ADDRESS LIST 


354 DOS Emulator Logic 


Service Aids Adjust CCW Data Address Routine 


FROM 34F/F5 
34F/E3, 
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34F/H4, 
34F/J4 


RCCWes3 


MOVE CURRENT 
BEBLK START 
ADDRESS TO LIST 
CCW POINTER 


{ITIVRCW Part 7 of 8) 


Flowchart 


3448, 


Service Aids Adjust CCW Data Address Routine (IIVRCW Part 
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Data Area Directory 
Emulator Macros 
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EMULATOR MODULE DIRECTORY 


Figure 28 contains information about the physical structure of the Emulator. ) 
The column headings and their meanings are: 


Module Name. The name of the object module containing the routine, table, 
or transient area being described. The microfiche cards containing program 
listings are ordered by object module names. 


Function. The Emulator routines are grouped according to operation: 
initialization, synchronous interruptions, asynchronous interruptions, direct- 
access volume sharing, abnormal end conditions, message writer, and service 
aids. The flowcharts in the section “Program Organization" are divided into 
these groups. For a precise definition of function as it relates to a 
particular routine, see the functional and routine descriptions given in the 
section "Method of Operation." 


Name of Routine, Table, Transient Area. The name of the routine, table, or 
transient area being described. 


Entry Point Name. Symbolic labels for routine entry points. 
Control Section Name. The name of the control section containing the item. 


PLM Reference - Description Page. The page on which a particular item is 
described. 


PLM Reference - Flowchart Number. The flowchart number for the appropriate 
routine. 


Entry Control PLil Reference 

Module Name of Routine, Table, Point Section Descrip- Chart 
Name runction Transient Area Name _ Name tion Pg. No. 
IGS019SA SIO,EOX,abn,. Start I/C, end-of-extent, channel end, J 

end, ce and abnormal end appendage IGGO19SA IGGQN19SA 73 187-18B 
IGGO019S1 Abn. end, ce Abnormal end/channel end appendage IGG919§1 IGGO019S1 74 19” 
IIVABN Abnormal ExXite-ABEND error routine TIVZ.B3 IIVARN 191 267-263 

and cond, 
IIVACI Service aids Synchronous intercept routine TIVACI ITIVZACI 108 330-3311 
IIVADD Init. IPL add routine IIVADD IIVADND 51 4-4) 
IIVADJ Sync.int. CCW adjustment routine IIVADJ IIVADJ 71 1620-165 
IIVAWV Sync.int. CAW verification routine ITIVAWV IIVAVV 68 120 
I1vccw Sync.int. Adjust CCW data address routine TIVccw IIVccw 69 15A-15F 
ITIVCHK Sync.int. Check I/O routine IIVCEK IIVCHK 61 9A-9D 
IIVCWV Sync.int. CCW verification routine IIVCWV IIVCWV 63 134 
IIVDVS D.A. volume shar. Device sharing simulation routine IIVDVS IIVDVS 80 23/A-23H 
IIVENT Init. DOS Emulator entry routine ITIVENT IIVENT 43 iP 
IIVENT Init. DOS Emulator constants area (E*UCOUS) -- IIVCON 435 fa 
IIVFCB Sync.int. Carriage tape storage image table IIVrcs IIVFCE 26 N/A 
IIVGET Init. GETMAIN/FREENAIN routine ITIVGET IIVGET 54 TE 
IIVGR2 D.A. volume shar. SVC monitor routine TIVGR2 IIVGR2 79 224-22D 
IIVINT Init. Initialization first-load routine IIVIiiT IIVINT 43 24-231 
IIVIN2 Init. Initialization second-load routine IIVIN2 ITVIN2 47 37-3F 
IIVIS D.A. volume shar. ISAM mapping routine IIVIS IIVIS 88 24A0=-24L 
TIVLOG Sync.int. Interpretive SYSLOG routine IIVLOG IIVLOG 62 104-10E 


Figure 28 (Part 1 of 2). Emulator Module Directorv 
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Module 
Name 


IIVLOG 
ITVLOG 


IIVHSG 
IIVMG1 
IIVNG2 


IIVIG3 


IIVOPN 
IIVPCE 
IIVPCI 
IIVPOV 
IIVPRP 
IIVPR1 
IIVPUR 
IIVpPwv1 
IIVPU2 
IIVPU3 
ITIVRAS 
ITIVPAES 
IIVRCP 


IIVRC? 
IIv2p1 


IIVRD2 
IIVRD3 
IIVRP1 
IIVRTE 
IIVPTE 
IIVETE 


IIVRTE 


ITIVRTE 
ITIVRTE 
ITIVRTE 
IIVRTE 
IIVSCI 
IIVSDT 
IIVSNP 
IIVSTG 
IIVSvVCc 


IIVVIO 
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Function 


Sync.int. 


Sync.int. 


Message writer 


Message writer 


Message writer 


Message writer 


Init. 


Sync.int. 


Service aids 


Sync.int. 


Async.int. 


Sync.int. 


Init. 


Sync.int, 


Sync.int. 


Sync.int. 


Service aids 


Service aids 


Service aids 


Service aids 


Sync.int. 


Sync.int. 


Sync.int. 


Sync. int. 


Rsync.int. 


async.int. 


Async.int. 


Async.int. 


Async.int. 


Async.int. 


Async.int. 


Async.int. 


Service aids 


Init. 


Service aids 


Sync.int. 


Sync.int. 


DJA. 


volume shar. 


Name of Routine, Table, 
Transient Area 


Interpretive SYSLOG routine 
Entry point 1 


Interpretive SYSLOG routine 
Entry point 2 


Message writer routine 
Initialization message texts 
Post-initialization message texts 


Volume sharing and service aids 
Message texts 


Open routine 

Program check executive routine 
Program check intercept routine 
Printer overflow routine 

Prompt reply processor routine 
1403/1443 printer translate table 
OS PUB table build routine 

1442 punch commands translate table 
2520 punch commands translate talle 
3525 punch commands translate~ table 
Service aids initialization routine 
Constants area (PATCONS) 

Command processor routine 


Service aids adjust CCV data address 
routine 


1442 reader commands translate 
table routine 


2520 reader commanas translate table 
2501 translate tahle 

2540 translate table 

Asynchronous interrupt exit routine 
Asynchronous interrupt check subroutine 
tnd-of-Jobh routine 


Asynchronous interrupt exit routine 
Entry point 1 


Route routine, entry point 2 

Select routine 

Timer interrupt subroutine 

Timer interrupt check subroutine 
Supervisor call intercept routine 
Staged device table 

SWAP dump and trace formatting routine 
Staged I/O routine 

Supervisor call routine 


Device sharing V?cc I/9 routine 


Entry 
Point 
Name 


IIVLOGRH1 


IIVLOGR2 


IIVMSG 


ITIVOPi1 
IIVPCE 
IIVPCI 
ITIVPOV 


IIVPRP 


IIVPUB 


LTIVRAS 


IIVPCP 


TIVE CHA 


IIVARTE 
TIVATICK 


IIVRTEOS 


IIVRTED1 
IIVRTI 2 
IIVRTESL 
ITIVRTET! 
TIMECER 
IIVSCI 
TIVSNP 
ITIVSTS 
TIVSVc 


IIVVIG 


Emulator Module Directory 


Control 
Section 


Name 


IIVLOG 


IIVLOG 
ITIVHSG 
IIVMG1 


IIVMG2 


IIVMG3 
IIVOPH 
IIVPCE 
IIVPCI 
IIVPOV 
TIVP RP 
IIVPR1 
IIVPUS 
TIVPU1 
IIVPU2 
IIVPU3 
LIVRAS 
ITIVACY 


IIVRCP 


TIVeC 


IIVED1 
IIVRD2 
IIVRD3 
IIVRP 1 
IIVRTE 
IIV2TE 


IIVRTE 


IIVRTE 
IIVRTE 
IIVRTE 
IIVRTE 
IIVRTE 
ITVSCI 
IIVSDT 
IIVSWP 
IIVSTG 
TIVSVC 


IIVVIO 


PLM Reference 


Descrip- 


tion Pg. 


€3 


63 
101 
101 
101 


101 


Chart 
No. 


10C 


10E 
274 
N/A 


N/A 


N/A 

5f- 5D 
82-80 
31A-31C 
147. 
21A-215 


w/a 


W/7 
iA 
282-282 
aA 
2972=29P 


347-3 4E 


W/ih 
N/A 
w/e. 
L/h 
207-206 
20-207 


205 


202 
20B 
20C 
20D 
20D 
32A 
ih 
302,-30K 
1124-113 
174 


25A- 257 
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DATA AREA DIRECTORY 


Figure 29 contains a summary of information about the major data areas used 
by the Emulator. The column headings and their meanings are: 


Data Area Name. Names the data area and its abbreviation, if there is one. 
Beginning Symbol. Identifies the beginning of the data area and can be used 
to locate the data area in the program listings. 

Creation. Contains some indication as to the origin of the data area. 
"Requestor" means that creation and maintenance of the data area is the 
responsibility of the requestor. -Other requestors do not have to explicitly 
create the needed data area. 


Storage Area. Indicates where the data area is in main storage. 


Size. Gives the size of the data area. 


Means of Access. Indicates the most commonly used way of referring to the 
data area or one of its fields. 


Beginning 
Data Area Name Symbol Created by Storage Area Size Means of Access 
mdjust CCW data RCCWLIST Emulator Emulator area 24 bytes Beginning symbol 
address list 
Beginning and BEBLK Emulator Emulator area 240 bytes Beginning symbol 
end block 
Channel address DOSCAW DOS DOS supervisor Word DOS storage area 
word (CAW) area plus 72 
Channel command None Requestor DOS problem Doubleword Address of requestor's 
word (CCW) when needed program area first CCW is contained 
in the DOS CAW 

Channel status DOSCS#7 Emulator DOS supervisor Doubleword DOS storage area plus 
word (CSW) area 64 
Command control DOSCCB DOS DOS problem 16 byte Register 1 at SIO 
block (CCB) program area entry for execution 

each channel 

program 
Communications COMTAB Emulator Emulator area 84 byte entry Address in IIVCON 
table (COMTAB) for each 

device + 1 for 

SYSLOG 
COMTAB extension CTEXT Emulator Emulator area 64 hytes Address in IIVCON 


DOS DOS Variable 
B- transient 
area + 1192 


DASD label (DLBL) DLBLDS Address in DOS open table 
for sequential disk; in 


problem program label area 


bytes for direct-access disks 

Data control IHACCB Cmulator Emulator area Variat.le COMTAB = symbolic 
block (pcB) (DSECT) names equated to 

offsets of fields 
Data event DECBECB Emulator Emulator area 26 bytes Immediately follows FIDBLK 
control block 
(DECB) -- EISAt 
Data extent None OS during Protected Varies with DCB - symbolic names 
block (DEB) open storage device and equated to offsets of 


Figure 29 (Part 1 of 3). 


360 DOS Emulator Logic 


Imulator area 


access metnod 


Data Area Directory 


fields 


J 


Data Area Name 
Data set control 


hlock (DSCB) -- 
format 1 


Data set control 
block (DSCB) -- 
format 3 


Data set 
control hlock 
(O5CR) -- 
format 4 

OIAG block 


DTTIS ADD-RETRVE- 
ADDRTR table 


OTFIS LOAD table 


Event control 
block (EC:) 


LCE pointer 
table 


Tile Ip block 
(FIDBLK) 


ITVesn 


TIVRCH 
Input/output 
plock (IOB) 


ISAM block 


ISK/5SK 
table 


Job file control 
block (JFCB) 


Local execution 


list 


Logical unit 
block (LUB) 


Figure 29 (Part 2 of 3). 


Beginning 
Symbol 
OBF1DATA. 


OBF3LBL 


None 


DIAGBLK 


IJiCcThu1 


IJHEATABL 


1.one 
ECBLIS?T 


(pointer) 


PILuLK 
(DSECT) 


ITVCOal 
IIV&CN 
IOEDSECT 
ISBLK 


(DSCCT) 


ISSKTAB 
(pointer) 


JPCBAREA 


-ADCRILIST 
{point to 
DRILIST) 


Wwone 


Created by 


OS space 
allocation 
routine or 
DOS onen 
routine 


OS space 
allocation 


routine or DOs 


open routine 


Utility 
programs 


Emulator 


DOS 


ie) 
i) 
cn 


Emulator 


Emulator 


Emulator 


Emulator 


Emulator 


Emulator 


Lmulator 


Cmulator 


Emulator 


DCs 


Storage Area 


VTOC 


LmMulator 


area 


Dee problem 
3rogram area 


COS problem 
program area 


COITAY 


Lmulator 


Lnulator 


Umulator 


Linulator 


Emulator 


Emulator 


[Emulator 


Auxiliary 


storage 


Lrulator 


DCS supervisor 


areca 


area 


area 


area 


area 


area 


area 


area 


aréa 


Size 


140 bytes 


140 bytes 


14) bytes 


112 hytes 


Variabla 


Variable 


Jord 


4 byte entry 
for each DCE, 
SYSLOG, and 

3 snecial 


snee 
DCES 


16 bytes 


1298 %ytes 


558 bytes 
10 words 


388 or 
C24 bytes 


1 byte entry 
for each 2K 
block of DOS 
storage 


176 bytes 


10 words 


2 byte entry 
for each 

logical unit 
in LUS table 


Data Area Directory 


Means of Access 


OBTAIN 


OBTAIN 


Channel progran 


Address in IIVCON 


boS register % (points to 
fullvrord constant) at SETL; 
BOS register 1 at CET/PUT/ 


LSCTL/READ/WPITL/WAITF: 


register 2 at OPEN/CLOSE 


DOs ragister 2 (points to 


fullword constant) at 


SLTTL/ENDFL; DOS register 
1 at WRITL; DOS register 2 


at OPEN/CLOSE 


COMTAE 


Address in IIVCoOvU 


redress in IIVConN 


External reference (see 
Lmulator linkage editor 
map) 


Acaress in module 
IIVRAS an@ IIVCOW 


COMTAE 

Address in ISFEGSV\ 
field (following 
FIDBLK field, which 
is pointed to by 


ITVCON) 


Trddress in IIVcoN 


RDJFC: macro (IIVCo!?) 


Pddress in IIVCCH 


Address in IIVCON and 


DOS communication region 
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Data Area Name 


Open table 


OS PUB table 


Physical unit 
block (PUB) 


Post ECB list 


Program informa- 
tion block (PIB) 


Program status 
word (PSil) 


DOS SVC old PSW 

DOS SVC new PSW 
DOS program old 
PS4 

DOS program new 
PS‘ 

DOS I/C old PSW 

DOS I/O new PSW 


DOS external old 
PSW 

DOS external nev 
PSW 

DOS macnine 
check old PSV 
nNOS machine 
check new PSW 


Staged I/0 
constants block 
(STGCON) 


Tape error 
block (TEB) 


Tape error by 
volume (TEBV) 


Task input/output 
table (TIOP) 


Unit control 
block (UCB) 


Volume label 
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362 


Beginning 


Symbol 


None 


None 


None 


DOSPI3B 


DOSSVOLD 
DOSSVNEW 
DOSPGOLD 
DOSPGNIW 


DOSIOOLD 
DOSIONEW 


DOSXTOLD 
DOSXTHLW 
DOSMCOLD 


DOSHCNEW 


STGCON 


lone 
Yone 


None 


wone 


OBVOL1 


Created by 


DOS 


Emulator 


DOS 


Emulator 


DOS 


DOS 


DCmulator 


LOS 


Os 


Utility 
programs 


DOS Emulator Logic 


Storage Area 


DOs 
B-transient 
area 


Emulator area 


DOS supervisor 


area 


Lmulator area 


DOS supervisor 


area 
Adjustment 
factor plus 
32 (20) 

96 (60) 

40 (28) 

104 (68) 


56 (38) 
120 (78) 


24 (18) 
38 (58) 
48 (30) 


112 (70) 


Dummy IOB 


Size Means of Access 


298 bytes 7ddress in DOS register 
15 when open phases are 
in control 

l-byte entry Address in IIVCON 
for each PUB 

entry 


Address in IIVCON and 
DOS communication 
region 


8 byte entry 
for each 
device in 

DOS PUB tahle 
2 byte entry Address in IIVCON 
for each device 


Address in IIVCON and 
DOS communication region 


16 bit entry 
for each PIB 
in PIB table 
Doubleword DOS storage assignment 
plus adjustment factor 


10 words COMTAE 


DOS supervisor 6 bytes PU 


area 


DoE sunervisor Variable 


area 


IFT-OS problem Variable 


program area 
Vr = 
protected 
storage 


oS nucleus 
Cylinder 0, 


track 0, 
record 3 


Address in DOS BG 
COMREG extension 


Address in IIVCON 


Variable DEB 


890 characters IIVCON 


Data Area Directory 


EMULATOR MACROS 


The Emulator program makes use of several macros, most of which are DSECTs, 
to describe common Emulator data areas. The macros are identified and described 
as follows (Figure 30): 


Emulator Tssuing 
Macro Module (s) Function 
COMTAB ITIVGR2, IIVPCE, IIVVIO Creates a DSECT that describes 
IITVPRP, IIVLOG, IIVIS one entry of the Emulator com 
TIVABN, ITVCHK, IIVSNP, munications table. 
TIVACI 
CTEXT TIVGR2, ITVDVS, IIVPCE, Creates a DSECT that describes a 
TIvVVIO, ItViIs, TIVSNP COMTAB extension entry. 
DEBD IIVPCE, YIVDVS Creates a DSECT named IIVDEB 
that describes a DEB. 
DLBLD ITIVGR2, LIVDVS Creates a DSECT named DLRLDS ~ 
that describes the DLBL card image. 
DOSCCB TIVPCE Creates a DSECT that describes 
the DOS CCB. 
DOSCOM IIVGR2, IIVDVS, IIVPCE, Creates a DSECT that describes the 
IIVCHK DOS communication region. 
DOSCORE TIVPRP, IIVLOG, IIVCHK, Creates a DSECT that describes the 
TIVRAS, YIVACI first 128 bytes of DOS storage. 
DOSPIB IIVOPN Creates a DSECT that describes the 
DOS PIB. 
DOSPUB ‘IIVPRP, IIVCHK Creates a DSECT that describes one 
DOS PUB table entry. 
DOSREGS All modules Equates labels to the 16 general 
purpose registers. 
DRILIST All modules (contained Creates a DSECT that describes the 
in EMUCONS) local execution list and the 
adjust CCW data address list. 
DTFD IIVGR2, IIVDVS Creates a DSECT named DTFDS 
that describes the DTF. 
DTFISDST IIvis Creates a DSECT that describes 


the DTFIS tables. 


Figure 30 (Part 1 of 3). Emulator Macros 
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Emulator 
Macro 


EMUCONS 


EMUMSG 


FYDBLK 


FMTRC 


TSBLK 


MGTXT 


MSGCODT 


OBTNWK 


Figure 30 


364 


Issuing 


Module (s) 
All modules 


TIVINT, 
IIVPUB, 
TIVSTG, 
TIVGET, 
TIVDVS, 
TIVRCW, 


TIVGR2, 
IIVSNP 


ITIVSNP 


TIVIS 


IIVMG1, 


TIVMG1, 


TIVDVS, 


(Part 2 of 3). 


IIVADD, 
TIVPRP, 
TIVRTE, 
IIVOPN, 
TIVRCP, 
TIVCHK 


IIVDVs, 


IIVMG2, 


EIVMG2, 


TIVVIO 


DOS Emulator Logic 


TIVIN2, 
IIVABN, 
IIVPCE, 
IIVGR2, 
TIVRAS, 


IIvis, 


TIVMG3 


TIVMG3 


Function 


Describes the Emulator constant 
area, which contains data constants 
common to most Emulator modules. 


EMUCONS can be used in two 
different ways: 


° If the positional parameter 
is omitted, it generates a 
CSECT called TIVcCON. This 
CSECT is the common data area 
of the Emulator. The CSECT 
Option is used by the Em lator 
entrv routine (TITVENT). 


° If the positional parameter 
DSECT is coded, this macro 
generates a DSECT called 
EMUCONS, which describes the 
Emulator constant CSECT, 
TIVCON. 


Provides linkage to the Emulator 
message writer (IIVMSG), which 
sends messages to the operator 
and programmer. 


Creates a DSECT that describes 
the FID. 


Creates a DSECT that describes 
the formatted trace table printed 
when the TRACE command is invoked 
by IIVSNP. 


Creates a DSECT that describes the 
ISAM block (ISBLK). 


Generates the message text and 
controls information for supple- 
mental text. 


Generates an index table to 
locate and process the message 
text. 


Creates a work area for vToc labels 
used by IIVVIO and IIVDVS. If 

the keyword parameter DSECT is 
present, only a DSECT to describe 
the area is generated. 


Emulator Macros 


Emulator Issuing 


Macro Module (s) Function 
( RASCONS IIVRAS, IIVRCP, IIVSNP, Describes Emulator service aids 
IIVACI, TIVPCI, LEVScCI constant area, which contains data 


constants required by all service 
aids modules. 


RASCONS can be used in two 
different ways: 


8 If the keyword parameter is 
omitted, it generates a CSECT 
called IITVRCN. This CSECT 
is the common data area of the 
service aids modules. The 
CSECT option is used by 
module IIVRAS. 


e If the keyword parameter 
DSECT is coded, this macro 
generates a DSECT called 
RASCONS, which describes the 
CSECT, IIVRCN. 


STGTAB TIVPUS, TIVOPN Creates a DSECT that describes 
module TIVSDT. 
TRCDSCT IIVACI, IITVPcCLI, IIVSCI, Creates a DSECT that describes the 
TIVSNP internal trace table format (see 


figure entitled “Internal Trace 
Table Format"). 


e Figure 30 (Part 3 of 3). Emulator Macros 


SYMBOL TABLE 


The symbols (or labels) in Figure 31 are contained in flowcharts in the "Program 
Organization" section of this publication. The list can be helpful when program 
listings are heing used. If there is a symbol at, or nearby the instructions 

in question, refer to this list to locate a flowchart, a routine name, ora 
module name that could either answer your question or provide a context that 
might lead to an answer. 


Users of this list should be aware of its limitations; in particular, the 
flowcharts do not contain all labels to be found in the program listings. 
A full description of the characteristics of the flowcharts appears in the 
"Program Organization" section. 
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Symbol 


ABSNAP 
ADDCHK 
ADDCHK20 
ADDPUB 
ADDSTG 
ADD2400 
ADD3400 
ADJ01 
ADJ02 
ADJ03 
ADJ04 
ADJO5 
ADJ06 
ADJ07 
ADJ08 
ADJ09 
ADJ 10 
ADJ11 
AERT000 
ASCHCKO4 
ASCHCKO 7 
ASCHCK08 
ASCHCKO09 
AS CHCK 10 
ASKOPR 
BASELEGO 
BISMSTAT 


BLDISK 
CERTO00 
CHECKERR 
CHECKNDE 
CHECKSDE 
CHECK000 
CHECKO0 1 
CHECK002 
CHECK003 
CHECKO04 
CHECKO 40 
CHECK050 
CHECKC 90 
CHECK095 
CHECK 1 
CHECK100 
CHECK1 10 
CHECK120 
CHKCUU 
CHKEOJ 
CHKIPL 
CHKLOG 
CHKPMT 
CHKRES 
CHKSIZ 
CHKTIM 
CHNCTE 
CHNCTEQO9 
CHNCTE10 
CHNCTE25 
CHNCTE30 
CHNCTE4 0 
CLOSE 
CLOSERTN 


Routine 


EXit-ABEND error routine 


IPL add 
IPL add 
IPL add 
IPL add 
IPL add 
IPL add 
cCcW adju 


routine 
routine 
routine 
routine 
routine 
routine 
stment 


CCW adjustment 


CCW adju 
CCW adju 


stment 
stment 


CCW adjustment 


CCW adju 
CCW adju 
CcW adju 
CCW adju 
CCW adju 
CcW adju 
Abnormal 


stment 
stment 
stment 
stment 
stment 
stment 
end ap 


routine 
routine 
routine 
routine 
routine 
routine 
routine 
routine 
routine 
routine 
routine 
pendage 


Asynchronous 
Asynchronous 
Asynchronous 
Asynchronous 
Asynchronous 


interrupt che 
interrupt che 
interrupt che 
interrupt che 
interrupt che 


ck subroutine 
ck subroutine 
ck subroutine 
ck subroutine 
ck subroutine 


ASKOPR subroutine 
FINDADDR subroutine 
EODAD, SYNAD, and status mapping 


routines 


Initialization second-load routine 
Channel end appendage 


Check I/ 
Check T/ 
Check I/ 
Check I/ 
Check I/ 
Check I/ 
Check I/ 
Check I/ 
Check I/ 
Check I/ 
Check I/ 
Check I/ 


O routi 
O routi 
O routi 
O routi 
O routi 
O routi 
O routi 
O routi 
O routi 
O routi 
O routi 
O routi 


Select routine 
Check I/O routine 
Check I/O routine 
Check I/O routine 
CHKCUU subroutine 


Tnitiali 


Zation 


Initialization 


Initiali 
Initiali 


zation 
Zation 


Initialization 


Initiali 
Initiali 


zation 
zation 


Initialization 


Initiali 
Initiali 
Initiali 
Initiali 
Initiali 


zation 
zation 
zation 
zation 
zation 


Device sharing 
Close mapping routine 
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1 Table 


ne 
ne 
ne 
ne 
ne 
ne 
ne 
ne 
ne 
ne 
ne 
ne 


First-load 
First-load 
first-load 
first-load 
first-load 
first-load 
first-load 
second-load 
second-load 
second=-load 
second-load 
second-load 
second-load 


routine 
routine 
routine 
routine 
routine 
routine 
routine 
routine 
routine 
routine 
routine 
routine 
routine 


simulation routine 


Module 


IIVABN 
ITVADD 
ITIVADD 
IIVADD 
IITVADD 
IITVADD 
IIVADD 
ITVADJ 
TIVADTI 
IIVADI 
IIVADJ 
ITVADJ 
TIVADJ 
IIVADI 
ITIVADS 
IIVADJI 
TIVADJ 
IIVADJ 
IGG019SA 
TIVRTE 
IIVRTE 
ITIVRTE 
TIVRTE 
IIVRTE 
IIVINT 
ITIVPCE 
TIVIS 


IIVIN2 
IGGO19SA 
TIVCHK 
IIVCHK 
ITIVCHK 
TIVCHK 
TIVCHK 
TIVCHK 
IIVCHK 
TIVCHK 
TIVCHK 
TIVCHK 
ITIVCHK 
TIVCHK 
IIVRTE 
ITIVCHK 
IIVCHK 
TIVCHK 
TIVINT 
IITVINT 
IIVINT 
IIVINT 
ITIVINT 
TIVINT 
TIVINT 
IITVINT 
TIVIN2 
TIVIN2 
TIVIN2 
TIVIN2 
IIVIN2 
TIVIN2 
IIVDVS 
TIVIS 


Symbol Chart Routine Module 
CLOSEO 23E Device sharing simulation routine IIVDVS 
CLOSEO 1 24C Close mapping routine IIvis 
CLOSE1 23E Device sharing simulation routine IIVDVS 
CLOSE1A 23E Device sharing simulation routine TIVDVS 
CLOSE2 23E Device sharing simulation routine IIVDVS 
CLOSE3 23E Device sharing simulation routine TIVDVS 
CLOSOPEN 24L EODAD, SYNAD, and status mapping IIvis 
routines 
CLS00000 22C SVC monitor routine IIVGR2 
CLS00050 22C SVC monitor routine TIVGR2 
CLS00200 22C SVC monitor routine IIVGR2 
CMD00 29A Command processor routine IIVRCP 
CMNDREJ 11K Staged I/O routine ITIVSTG 
CNTENT10 2E Initialization first-load routine IIVINT 
COMBINE 15F Combine subroutine TIVCCW 
34H Service aids adjust CCW data address TIVRCW 
routine 
COMB0 1 15F Combine subroutine TIVccWw 
34H Service aids adjust CCW data address TIVRCW 
routine 
COMB02 15F Combine subroutine ITIVccw 
34H Service aids adjust CCW data address ITIVRCW 
routine 
COMB03 15F Combine subroutine IIVccw 
34H Service aids adjust CCW data address IIVRCW 
routine 
COMBO 4 15F Combine subroutine TIVccw 
34H Service aids adjust CCW data address TIVRCW 
routine 
COMBOYA 15F Combine subroutine IIVvccw 
34H Service aids adjust CCW data address ITVRCW 
routine 
COMBO5 15F Combine subroutine IIVCCW 
34H Service aids adjust CCW data address IIVRCW 
routine 
COMB06 15F Combine subroutine IIVccw 
34H Service aids adjust CCW data address IIVRCW 
routine 
COMB07 15F Combine subroutine TIvcecw 
34H Service aids adjust CCW data address ITIVRCW 
routine 
COMB08 15F Adjust CCW data address routine IIVvccw 
34H Service aids combine subroutine IIVRCW 
CSWSTOR 11d Staged I/O routine IIVSTG 
CTLRIN 8T Load/store control register subroutine IIVPCE 
CVTHEX 29D CVT subroutine IIVRCP 
CVTMSK 29D CVT subroutine IIVRCP 
CVTNUM 29D CVT subroutine IIVRCP 
CVTUPP 29D CVT subroutine TIVRcP 
CVT00 29D CVT subroutine IIVRCP 
CVT02 29D CVT subroutine TIVRCP 
CVT11 29D CVT subroutine IIVRCP 
CVT18 29D CVT subroutine IIVRCP 
CVT20 29D CVT subroutine IIVRCP 
CVT30 29D CVT subroutine TIVRCP 
CVT40 29D CVT subroutine ITIVRCP 
CXRET 24A Main task control executive routine IIvIs 
DDSCAN 2M DDSCAN subroutine YTIVINT 
DDSCAN10 2M DDSCAN subroutine ITIVINT 
DDSCAN2 0 2M DDSCAN subroutine IIVINT 
DDSCAN22 2M DDSCAN subroutine IIVINT 
DDSCAN24 2M DDSCAN subroutine IIVINT 
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Symbol 


DDSCAN25 
DDSCAN30 
DELFF 
DELPUB 
DELPUB40 
DELOO 
DIAGCCW 
DIAGC20 
DIAGC21 
DIAGINIT 
DIAGINV 
DLBL 
DLBLO 
DLBLOA 
DLBL1 
DLBL10 
DLBL2 
DOSPUB10 
DVSMSG 
ECBSCN 
ECBSCNO1 
ECBSCNO 4 
ECBSCNO08 
ECBSCN10 
ENDINIT 
ENDLOAD 
ENDO1 
ENDO 2 
ENDO9 
END 10 
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TIVRCW 
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RCCW13B 
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RCCWD25 
RCCWD26 
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RCPPRINT 
RDJFCB 
RDNOWORK 
READRTN 
READ100 
READ9Y99 
RESET 
RETURN 


RETURN 1 
RMSRESET 
ROUTEOS 


ROUTE10 


ROUTE11 
ROUTE1 1A 
ROUTE12 
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RCPPRINT subroutine 
Initialization first-load routine 
WAITF mapping routine 
Read key mapping routine 
GETWORD subroutine 
Command processor routine 

Device sharing simulation routine 
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SVC monitor routine 
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TIVCCW 
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ITIVCCW 
ITIVRCW 


IIVCCW 
ITIVRCW 


TIVCCW 
TIVRCW 


IIVCCW 
TIVRCW 
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IIVRCW 
ITVRCW 
ITIVRCW 
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TIVRCP 
TIVINT 
IIVIS 

TIVIS 

TIVRCP 
ITIVRCP 
TIVDVS 
ITVDVS 
TIVRCP 
TIVDVS 
IIVGR2 
TIVRTE 
ITIVRTE 
IIVRTE 
ITIVRTE 
TIVRTE 
ITIVRTE 
LTIVRTE 
TIVRTE 


IIVRTE 
IIVRTE 
TIVRTE 
IGG019SA 
IGGO019SA 
TIVACT 
> IVACT 
ITIVACT 
TIVACT 
TIVACTI 
IIVACTI 
TIVACT 
TIVACT 
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RTER2325 33G Asynchronous intercept routine IITVACI 
RTER2999 33H Asynchronous intercept routine IIVACT 
RTRN 26A EXit-ABEND error routine TIVABN 
RWUCHK 9C Check I/O routine TIVCHK 
SCAN 2K Scan subroutine ITIVINT 
SCANFID 22D SVC monitor routine LIVGR2 
SCKRTN 8U Set clock subroutine IIVPCE 

S EEKCHK 8L SIO subroutine TIVPCE 
SEEKDVS 8P SEEKDVS subroutine TIVPCE 
SEEKTEST 8K SEEKTEST subroutine TIVPCE 
SEEK0300 8P SEEKDVS subroutine LIVPCE 
SEEK0350 8P SEEKDVS subroutine TIVPCE 
SEEK0400 8P SEEKDVS subroutine TIVPCE 
SEEK05C0 8P SEEKDVS subroutine TIVPCE 
SEEK0501 8P SEEKDVS subroutine TIVPCE 
SEEK0504 8P SEEKDVS subroutine TIVPCE 
SEEK0509 8P SEEKDVS subroutine ITIVPCE 
SEEK05 10 8P SEEKDVS subroutine TIVPCE 
SELINT1 20C Select routine ILIVRTE 
SELINT2 20C Select routine TIVRTE 
SELINT3 20C Select routine ITIVRTE 
SELINT4 20C Select routine IIVRTE 
SENSE 11K Staged I/O routine LIVSTG 
SETBITS 19A Abnormal end/channel end appendage IGG019S1 
SETDAT 4C IPL add routine ITVADD 
SETEXTO 23EB Device sharing simulation routine IIVDVS 
SETFDAD 23A Device sharing simulation routine TIVDVS 
SETLRTN 24D SETL mapping routine IIvis 
SETRTRN 24L EODAD, SYNAD, and status mapping TIVIS 

routines 
SETSKCHK 8L SIO subroutine IIVPCE 
SETSVC50 24L EODAD, SYNAD, and status mapping IIiviIs 
routines 

STIOBUSY 8d SIO subroutine TIVPCE 
SIOCNT 8L SIO subroutine TIVPCE 
SIOINSOO 18A Start I/O appendage IGG019SA 
SIOINOS 18A Start I/O appendage IGG019SA 
SIOINO6 18A Start I/O appendage IGG019SA 
SITOIN100 18A Start I/O appendage IGG019SA 
SIOIN105 18A Start I/O appendage IGGO19SA 
SIOIN110 18A Start I/O appendage IGGO019SA 
SIOPENED 87 SIO subroutine IIVPCE 
SIORTN 8J SIO subroutine IIVPCE 
STORTO00 18B Start I/O appendage IGG019SA 
SIORTO10 18B Start I/O appendage IGGO19SA 
SIORTO15 18B Start I/O appendage IGG019SA 
STORTO 20 18B Start I/O appendage IGG019SA 
SIORTO30 18B Start I/O appendage IGG019SA 
SIORT500 18A Start I/O appendage IGG019SA 
SIOSASK 8L STO subroutine IIVPCE 
SIOSN 8N SIO subroutine ITIVPCE 
STOSNO 8N SIO subroutine IIVPCE 
SIOSN1 8N SIO subroutine ITIVPCE 
SIOSN2 8N SIO subroutine TIVPCE 
SIOSN3 8N SIO subroutine TIVPCE 
SIOSN4 8N SIO subroutine ITIVPCE 
SIOSN6 8N SIO subroutine TIVPCE 
SIOSN7 8N SIO subroutine TIVPCE 
SIOSN7A 8N SIO subroutine TIVPCE 
SIOSTART 8M SIO subroutine TIVPCE 
SIOXDASD 8K STO subroutine IIVPCE 
SIOXIOB 8K SIO subroutine TIVPCE 
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STOXTAPE 
SI0O10 
SIO2 
STO3 
SIO4 
SIO5 
SKIP 
SNPALL 
SNPATTN 
SN PCOMP 
SNPCPSUB 
SNPC P40 
SNPCUU 
SNPEAT 
SNPHIO 
SNPINIT 
SNPINT 
SNPINV 
SNPIO 
SNPISK 
SNPLPSW 
SNPPC 
SNPPSW 
SNPSIO 
SNPSSK 
SNPSSM 
SNPSUBOP 
SNPSVC 
SNPSV10 
SNPSV11 
SNPSV20 
SNPSV30 
SNPSV50 
SNPTCH 
SNPTIMER 
SNPTIO 
SPECTAL 
SRTCUU 
SSKRTN 
SSMRTN 
STAERTRY 
STCKRTN 
STGIO0N00 
STGIOOO4 
STGIO020 
STGIO040 
STGIO050 
STGIO068 
STGIO100 
STGIO105 
STGIO 
STGIO110 
STGIO125 
STGIO200 
STGIO300 
STGIO40N0 
STGIO75A 
STGIO75B 
STIDPRTN 
STOALL 
STODOS 
STOEMBLK 
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Load FCB subroutine 
Read FCB subroutine 
Read FCB subroutine 
Staged I/O routine 
Staged I/O routine 
Store CPU ID subroutine 
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ITIVPCE 
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TIVPCE 
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IIVPOV 
TIVRCP 
ITVRCP 
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TIVRCP 
IIVRCP 
TIVRCP 
TIVRCP 
IIVRCP 
TIVRCP 
IIVRCP 
ITIVRCP 
IIVRCP 
TIVRCP 
ITVRCP 
LIVRCP 
IIVRCP 
IIVRCP 
IIVRCP 
IIVRCP 
TIVRCP 
IIVRCP 
TIVRCP 
TIVRCP 
TIVRCP 
IGG0198S1 
IITVIN2 
TIVPCE 
TIVPCE 
TIVRTE 
IIVPCE 
IIVSTG 
TIVSTG 
TIVSTG 
TIVSTG 
IIVSTG 
TIVSTG 
TIVSTG 
TIVSTG 
TIVSTG 
ITIVSTG 
IIVSTG 
TIVSTG 
TIVSTG 
TIVSTG 
TIVSTG 
IIVSTG 
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TIVRCP 
IIVRCP 
TIVRcP 
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STOEMU 29K Storage subroutines IIVRCP 
STOFST40 3D Initialization second-load routine IIVIN2 
STOINIT 29K Storage subroutines TIVRCP 
STOINV 29K Storage subroutines IIVRCP 
STONODOS 29K Storage subroutines IIVRCP 
STONUMBR 29K Storage subroutines TIVRCP 
SVC00100 32A Supervisor call intercept routine IIVSCI 
S$VC00150 32A Supervisor call intercept routine TIVSCI 
SVC00250 32A Supervisor call intercept routine IIVSCL 
SVC 100 17A Supervisor call routine TiIvsve 
SVc150 17A Supervisor call routine IIvsvc 
SVc160 32A Supervisor call intercept routine TIVSCI 
SVC200 17A Supervisor call routine IIVsSvc 
SVC300 17A Supervisor call routine IIvsve 
SVC320 17A Supervisor call routine TIVSVC 
SVC350 17A Supervisor call routine TIVSVCc 
SVC400 17A Supervisor call routine TIVSVCc 
SVC450 17A Supervisor call routine IIvsve 
SVC500 17A Supervisor call routine TIVSVC 
SVvc6C0 17A Supervisor call routine TIVSVC 
SYNA 11N SYNAD subroutine TIVSTG 
SYNADRTN 24L EODAD, SYNAD, and status mapping IIVIS 
routines 

TCHRTN 8E TCH simulation subroutine TIVPCE 
TIMECHK 20D Timer interrupt check subroutine TIVRTE 
TIMECHK1 20D Timer interrupt check subroutine ILIVRTE 
TIOPOSTD 8G TIO simulation subroutine TIVPCE 
TIORTN 8F TIO simulation subroutine TIVPCE 
TIOSCAN 8G TIO ITIVPCE 
TIOSRCH 8F TIO simulation subroutine TIVPCE 
TIOWAIT 8G TIO simulation subroutine TIVPCE 
TIOXLOG 8F TIO simulation subroutine TIVPCE 
TIOXLOG1 8F TIO simulation subroutine TIVPCE 
TIOX2321 8F TIO simulation subroutine TIVPCE 
TRCALL 29F Trace subroutines IIVRCP 
TRCATTN 29F Trace subroutines TIVRCP 
TRCCUU 29F Trace subroutines TIVRCP 
TRCEXT ‘ 29F Trace subroutines TIVRCP 
TRCHIO 29E Trace subroutines TIVRCP 
TRCINIT 29E Trace subroutines IIVRCP 
TRCINT 29F Trace subroutines TIVRCP 
TRCINV 29E Trace subroutines TIVRCP 
TRCIO 29F Trace subroutines TIVRCP 
TRCISK 29E Trace subroutines IIVRCP 
TRCLPSW 29E Trace subroutines TIVRCP 
TRCNUMBR 29F Trace subroutines TIVRCP 
TRCNWRAP 29F Trace subroutines TIVRCP 
TRCSIO 29E Trace subroutines TIVRCP 
TRCSSK 29E Trace subroutines IIVRCP 
TRCSSM 29E Trace subroutines TIVRCP 
TRCSVC 29F Trace subroutines IIVRCP 
TRCTCH 29E Trace subroutines TIVRCP 
TRCTIMER 29F Trace subroutines IITVRCP 
TRCTIO 29E Trace subroutines ITIVRCP 
TRCWRAP 29F Trace subroutines IIVRCP 
TSTOPN 22B SVC monitor routine IIVGR2 
VIOA 25A VToc I/O simulation routine TIvvio 
VIOA2 25A VTOC I/O simulation routine IIVVIO 
VIOB 25B VToc I/O SimUlation routine IIVVIO 
vViIoc 25B vtToc I/70 simulation routine TIVVIO 
viIoc1 25B vtToc I/0 simulation routine TIVVIO 
VIOD 25B VtToc I/0 simulation routine TIVVIO 
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VIOE 
VIOERRX 
VIOF 
VIOG 
VIOH 
VIOI 
VIOIO 
VIOIOA 
VIOIOB 
VIOIOB1 
vVroroc 
VIOIOD 
VIOIOE 
VIOIOF 
VIOIOSIM 
VIOIOX1 
VIOIOX2 
VIOJ 
VIONXT 
VIONXT1 
VIORT RN 
WKNBLKD 
WRTIKNRTN 
WRTKN100 
WRTKN101 
WRTKN200 
WRTKRTN 
YESORNO 
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vtToc I/0 
vtToc I/70 
VTOC I/0 
vtToc I/0 
vtToc I/0 
vtoc I/70 
vtToc I/0 
vToc I/0 
vVTOC I/0 
vToc I70 
vToc I/0 
vtToc I/0 
vToc I/0 
vtToc I/70 
vtToc I/0 
vtToc I/0 
vtToc I/0 
vToc 170 
vVTOC I/0 
vToc I/0 
vtToc I/0 
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Write NEWKEY 
Write NEWKEY 
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simulation 
Simulation 
Simulation 
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Simulation 
Simulation 
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Simulation 
Simulation 
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routine 
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routine 
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Write key mapping routine 
YESORNO subroutine 
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IIVVIO 
TIVVIO 
IIVVIO 
TIVVIO 
IIVVIO 
TIVVIO 
IIVVIO 
TIVVIO 
TIVVIO 
YIVVIO 
IITVVIO 
IIVVIO 
IIVVIO 
TIVVIO 
IIVVIO 
IIVVIO 
ITIvvVIo 
LIVVIO 
IIVViIO 
IIVVIO 
TIVVIO 
IIVIS 

IIVIS 

IIVIS 

LIVIS 

TIVIS 

IIViIS 

IIVINT 


FIELD NAME TABLE 


The field names in Figure 32 are contained in data areas which are initialized, 
modified, or interrogated by the Emulator. The list can be of help in 
identifying a field name with its data area and its location within that area. 
Although field names for DOS and OS data areas are included, they are limited 
to those significant to the Emulator. A full description of each field is 
included in the "Data Areas" section. 


Hexadecimal 
Field Name Location Data Area 
AASCHCK EO EMUCONS 
ABADR KEG EMUCONS 
ABEBLK 4CY EMUCONS 
ABGPIB EC EMUCONS 
ABGSYSRD 44s EMUCONS 
ACOMTAB 98 EMUCONS 
ACOMTABX cy EMUCONS 
ACOMT BEX co EMUCONS 
ACTEXEND c8 EMUCONS 
ADDRWRK 1CcC EMUCONS 
ADOSBTND 494 EMUCONS 
ADOS BTR 490 EMUCONS 
ADOSPUB 9C EMUCONS 
ADRILIST 50c EMUCONS 
AEMUCONS 514 EMUCONS 
AEOJ CHK 4D EMUCONS 
AF1PIB 454 EMUCONS 
AF2PIB 4u50 EMUCONS 
ATIVADJ 5B8 EMUCONS 
AIIVCCW 5B4 EMUCONS 
AIIVDVS 45C EMUCONS 
ATIVGET 518 EMUCONS 
AIIVGR2 458 EMUCONS 
AITITVISM 460 EMUCONS 
AITIVMSG 4CO0 EMUCONS 
ATIVOBE1 508 EMUCONS 
ATIVPCI 188 RASCONS 
ATIVPOV 478 EMUCONS 
AIIVSCI 194 RASCONS 
AIIVSDT 488 EMUCONS 
AIIVVIO 4“sc EMUCONS 
AOPEN EC EMUCONS 
AOSPUB 1D0 EMUCONS 
APC 4FC EMUCONS 
ARASCONS “64 EMUCONS 
ARASNP 1A4 RASCONS 
ARASPCE 180 RASCONS 
ARASRTE 198 RASCONS 
ARASSVC 18¢c RASCONS 
AROUTE 504 EMUCONS 
AROUTEEP 500 EMUCONS 
ART20 UFO EMUCONS 
ASTCBADR D8 EMUCONS 
ASTGIO UE8 EMUCONS 
ASVC Fs EMUCONS 
ASYNEXAD 1BC RASCONS 
ASYNEXRN 1D8 RASCONS 
ATIMER QFy EMUCONS 
BADCUU 1F7 EMUCONS 
BAS EREGS 50C EMUCONS 
BHDFP.1 238 RASCONS 
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BREGSAVE 
CAWSCNAD 
CCB 
CCWSCNAD 
CCW2ADDR 
CEAIDS 
CHNINDX 
CMPBLK 
CMPBLK2 
CMPLEN 
COMCAW 
COMCCWSA 
COMFMSK 
COMKEY 
COMTABEN 
CPUID 
CSCDLB 
CTDCBPTR 
CTDCBUC 
CTDDNAME 
CTDSNAME 
CTECHPTR 
CTEXTCNT 
CTEXTFLG 
CTEXTPTR 
CTFLAG 
CTFLAG2 
CTFLAG3 
CTFLAG4 
CTLREGS 
CTLRO 
CTLR14 
CTLR15 
CTLR2 
CTULEXT 
CTXTNSAV 
CUUSAVE 
DADCB 
DADCBLEN 
DBUGDCB 
DCBBLKSI 
DCBDDNAM 
DCBEODAD 
DCBEXCD1 
DCBEXCD2 
DCBIFLGS 
DCBKEYLE 
DCBLPDA 
DCBLRECL 
DCBMAC 
DCBMACR 
DCBNOREC 
DCBNREC 
DCBOFLGS 
DCBOPTCD 
DCBPTR 
DCBRECFM 
DCBRKP 
DCBRORG1 
DC BRORG2 
DCBRORG3 
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EMUCONS 
EMUCONS 
Open ta 
EMUCONS 
COMTAB 

EMUCONS 
EMUCONS 
RASCONS 
RASCONS 
RASCONS 
COMTAB 

COMTAB 

COMTAB 

COMTAB 

EMUCONS 
EMUCONS 
Open ta 
COMTAB 

COMTAB 

COMTAB 

COMTAB 

COMTAB 

EMUCONS 
COMTAB 

COMTAB 

COMTAB 

COMTAB 

COMTAB 

COMTAB 

EMUCONS 
EMUCONS 
EMUCONS 
EMUCONS 
EMUCONS 
COMTAB 

COMTAB 

RASCONS 
EMUCONS 
EMUCONS 
EMUCONS 
DCB 
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ea 


Data Ar 


ble 


ble 

extension 
extension 
extension 
extension 
extension 


extension 


Field Name 


DCBSYNAD 
DCBTDC 
DCELFBNR 
DEBBINUM 
DEBCEA 
DEBDVMOD 
DEBENDCC 
DEBENDHH 
DEBEOEA 
DEBNMTRK 
DEBS IOA 
DEBSTRCC 
DEBSTRHY 
DEBXCEA 
CLECBAREA 
DECBDCBA 
CECBEXC1 
DECBEXC2 
DECBKEY 
DECBLOGP. 
DEVTYP 
DIAGBLK 
DIAGBUF 
DIAGCUU 
DIAGFLG 
DIAGLNG 
DIAGNXT 
DIAGREL 
DOSBIN 
DOSCAW 
DOSCCB 
DOSCSW 
DOSCUU 
DOSRFTB 
DOSSIZE 
DRELEASE 
DSFIDBLK 
DS1DSIND 
DS1FMTID 
DS1TPTRDS 
DS4DEVDT 
DS4DSREC 
DS4VTOCE 
DS4VTOCI 
DTFFLNME 
DTFLMODA 
DTFRCTGD 
DTF TYPE 
ECB 

ECB 
ECBLIST 
ECBLIST 
EMUCCW1 
EMUCCW2 
EMUCONS 
EMULBLAD 
EMUPATCH 
EMUSAVE 
ENDPTECB 
EOQJSW 
EXMSG 
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ee) 
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101 
1E5 


Data Area 


DCB 

DCB 

UCB 

DEB 

DEB 

DEB 

DEB 

DEB 

DEB 

DEB 

DEB 

DEB 

DEB 

DEB 
DECB 
DECB 
DECB 
DECB 
DECB 
DECB 
COMTAB 
RASCONS 
RASCONS 
RASCONS 
RA SCONS 
RASCONS 
RASCONS 
RASCONS 
COMTAB 
CAW 

CCB 

CSW 
COMTAB 
EMUCONS 
EMUCONS 
EMUCONS 
EMUCONS 
DSCB-F1 
DSCB-F1 
DSCB-F1 
DSCB-F4 
DSCB-F4 
DSCB-F4 
DSCB-F4 
DTFIS tables 
DTFIS tables 
DTFIS ADD-RETRVE-ADDRTR table 
DTFIS tables 
COMTAB 
ECB 
EMUCONS 
ECB pointer table 
COMTAB 
COMTAB 
EMUCONS 
EMUCONS 
EMUCONS 
EMUCONS 
EMUCONS 
EMUCONS 
RASCONS 


Field Name Table 


Directories 383 


Field Name 


EXTMSK 
FCBCCW 
FCBCCWCT 
FCBCCWDA 
FCBCCWFG 
FCBCCWOP 
FCBCCWX 
FIDBLK 
FIDCTXTN 
FIDLTK 
FIDNXT 
FIDPRV 
FIDTFNME 
F4INCORE 
F4INDIC 
HDRDATE 
HDRPAGE 
HDRTIME 
HDR1 
HEXTAB 
HYPLIST 
H1 
ITIVCON 
ITIVCONB1 
LIVCONB2 
IIVCONB3 
TIVRCN 
IJHAARAD 
IJ HACFID 
IJHACLNK 
IJ HACOCR 
IJ HACOFC 
IJHACORC 
IJHAC OTC 
IJ HACPRC 
IJHACRID 
IJ HACTIN 
IJHACTNA 
IJHACTOA 
IJHACUSE 
IJHADKEY 
IJHAISKY 
IJ HCATB2 
IJHCATB3 
IJHCBLSZ 
IJHCCCB 
IJHCCCW 
IJHCCLPA 
IJHCKYLC 
IJHCKYSZ 
IJHCOPT 
IJHCRARA 
IJHCRESZ 
IJHCRREY 
IJHCRTR 
IJHCRWOR 
IJHCSADR 
IJHCSTBY 
IJHKADCN 
IJHKBKLN 
IJHKCCB 
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Data Area 


EMUCONS 
EMUCONS 
EMUCONS 
EMUCONS 
EMUCONS 
EMUCONS 
EMUCONS 


ISBLK 


FIDBLK 
FIDBLK 
FIDBLK 
FIDBLK 
FIDBLK 
Open table 
Open table 
RASCONS 
RASCONS 
RASCONS 
RASCONS 
EMUCONS 
EMUCONS 
EMUCONS 
EMUCONS 
EMUCONS 
EMUCONS 
EMUCONS 
RASCONS 


DTFIS 
DTFIS 
DTFIS 
DTFIS 
DTFIS 
DTFIS 
DTFIS 
DTFIS 
DTFIS 
DTFIS 
DTFIS 
DTFIS 
DTFIS 
DTFIS 
DTFIS 
DTFIS 
DTFIS 
DTFIS 
DTFIS 
DTFIS 
DTFIS 
DTFIS 
DTFIS 
DTFIS 
DTFIS 
DTFIS 
DTFIS 
DTFIS 
DTFIS 
DTFIS 
DTFIS 
DTFIS 
OTFIS 
DTFIS 


Field Name Table 


ADD-RETRVE-ADDRTR 
ADD-RETRVE~ADDRTR 
ACD-RETRVE-ADDRTR 
ADD- RETRVE-ADDRTR 
ALD-RETRVE<ADDRTR 
ADD=RETRVE-ADDRTR 
ADD-RETRVE-ADDRTR 
AD D- RETRVE-ADDRTR 
ADD-RETRVE-~ADDRTR 
ADD- RETRVE-ADDRTR 
AI D~RETRVE-ADDRTR 
ALD-RETRVE-ADDRTR 
ADD-RETRVE-ADDRTR 
AT D-RETRVE-ALGDRTR 
ADD-RETRVE~ADDRTR 
ADD- RETRVE-ADDRTR 
ADD-RETRVE-ADDRTR 
ADD-RETRVE-ADDRTR 
ADD-RETRVE-ADDRTR 
ADD-RETRVE-ADDRTR 
ADD-RETRVE~ADDRTR 
ALD-RETRVE~ADDRTR 
ADD-RFTRVE~-ADDRTR 
ADD~RETRVE-~ADDRTR 
ADD-RETRVE-ADDRTR 
AC D-RETRVE-ADDRTR 
ADD~RETRVE-ADDRTR 
AI D-~RETRVE-ADDRTR 
ADD-RETRVE-ADDRTR 
ADD~RETRVE-ADDRTR 
Ar D-RETRVE-ADDRTR 
load table 

load table 

load table 


table 
table 
table 
table 
table 
table 
table 
table 
table 
table 
table 
table 
table 
table 
table 
table 
table 
table 
table 
table 
table 
table 
table 
table 
table 
table 
table 
table 
table 
table 
table 


Hexadecimal 


Field Name Location Data Area 

IJHKCCOD 1E DTFIS load table 

IJHKLGLN uA DTFIS load table 

IJHKLPDR 42 DTFIS load table 

IJ HKOPCO 15 DTFIS load table 

IJHKPRCT 6C DTFIS load table 

IJHKRDWR 98 DTFIS load table 

IJHRADSV 48 DTFIS ALD-RETPRVE-~ADDRTR table 
IJHROVCN 54 DTFIS ADD-RETRVE-ADDRTR table 
IJHRREGS 46 DTFIS ADD-RETRVE-ALDDRTR table 
IJHSCADR 30 DTFIS ADD-RETRVE-ADDRTR table 
IJHSDB1 18 DTFIS ALDD-RETRVE-ADDRTR table 
TIJHSTOAR 8 DTFIS ADD-RETRVE-ADDRTR table 
IJHSLIOR 1c DTFIS ADD-RETRVE-ADDRTR table 
IMGLBDCB 468 EMUCONS 

IOB 38 COMTAB 

TOBCSW 9 IOB 

IOBDCBPT 15 IOB 

IOBECBPT 5 IOB 

ITOBFLAG1 0 Ios 

IOBSE EK 21 IOB 

ITOBSFEKM 20 TOB 

IOBSENSO 2 TOB 

IOBSENS1 3 IOB 

LOBSTART 11 IOB 

IPLCUU CE EMUCONS 

IPLOFST D3 EMUCONS 

IPLSTMT 498 EMUCONS 

IPLSW 1D8 EMUCONS 

TSAMCODE 104 EMUCONS 

ISAMDTFA 105 EMUCONS 

ISAMFDCX 108 EMUCONS 

ISAMLIST 104 EMUCONS 

ISCODE 68 ISBLK 

ITSCOMTAB 6C ISBLK 

ISDCB 78 ISBLK 

ISDCB1 184 TSBLK 

ISDECB 164 ISBLK 

ISDTFA 69 ISBLK 

I SDTFLMA 180 ISBLK 

ISECB 5C TSBLK 

ISFIDBLK 110 EMUCONS 

ISFLAGS 74 ISBLK 

ISLIST 68 ISBULK 

ISREGSAV 0 ISBLK 

ISREGSVA 64 ISBLK 

ISSKTAB F8 EMUCONS 

ISTCB 60 ISBLK 

TSWKNARA 70 ISBLK 

JFCBAREA 394 EMUCONS 

J FCBBS 3FA EMUCONS 

JFCBDSJIN 3AA EMUCONS 

J FCBDSN 394 EMUCONS 

JFCBDSNM 0 JFCB 

JFCBDS 18 3A5 EMUCONS 

JFCBDS19 3A6 EMUCONS 

JFCBDS8 39C EMUCONS 

JFCBIB 3c8 EMUCONS 

JFCBIND2 3EB EMUCONS 

JFCBIP 3D6 EMUCONS 

JFCBLKSI 66 JFCB 

JFCBLTYP 42 JFCB 
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Field Name 


JFCBMSK1 
JFCBTSDM 
JFCBUFIN 
JFCBUFL 
JFCBUFNO 
JFCBVOLS 
JFCBVSER 
JFCBVSR1 
JFCBVSR3 
JFCCYLOF 
JFCDSORG 
JFCFCBID 
JFCKEYLE 
JFCLRECL 
JFCNCP 
JFCNTM 
JFCOPTCD 
JFCRECFM 
JFCRKP 
LABADDR 
LEXADR 
LEXMSG 
LEXRTN 
LHDR1 
LIMTBCKT 
LINECNT 
LOGCUU 
LOGIO 
LOGOFST 
LOPTMSG1 
LPSWSVE 
MODNM 
MSGIN 
MSGINDIC 
MSGOUT 
MSGWF 
NBRENT 
NBR2K 
NOITOPEND 
NOSIO 
NXTBTR 
OLDBTR 
OPENLIST 
OPTBFLGS 
OPTBFLPT 
OPTBLNK 
OPTBSYFL 
OPTCUU 
OPTFLGR2 
OPTION 
OPTMSG1 
OSBIN 
OSCUU 
PAGECNT 
PARMCLSE 
PARMCODE 
PARMDTFA 
PARMEOX 
PARMFDCX 
PARMFLG 
PARMLST 
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Data Area 


EMUCONS 


EMUCONS 
Open table 
RASCONS 
RASCONS 
RASCONS 
RASCONS 
Open table 
RASCONS 
EMUCONS 
EMUCONS 
EMUCONS 
RASCONS 
RASCONS 
RASCONS 
Open table 
Open table 
Open table 
Open table 
EMUCONS 
EMUCONS 
EMUCONS 
EMUCONS 
EMUCONS 
EMUCONS 
EMUCONS 
Open table 
Open table 
Open table 
Open table 
RASCONS 
EMUCONS 
RASCONS 
RASCONS 
COMTAB 
COMTAB 
RASCONS 
EMUCONS 
EMUCONS 
EMUCONS 
EMUCONS 
EMUCONS 
EMUCONS 
EMUCONS 
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Field Name Location Data Area 
PARMLTK 108 EMUCONS 
PARMOPEN 1c EMUCONS 
PCEXITAD 1B4 RASCONS 
PCEXRTN 1¢8 RASCONS 
PECBPTR1 BO EMUCONS 
PECBPTR2 BY EMUCONS 
PENDSW 1D9 EMUCONS 
POSTECB B8 EMUCONS 
PROMPECB 4DC EMUCONS 
PRPCONTF 594 EMUCONS 
PRPCUUC 4BC EMUCONS 
PRPCUUWK 4B8 EMUCONS 
PRPMSGJN 1DF EMUCONS 
PRPMSG99I 1DA EMUCONS 
PRPRPLY 51D EMUCONS 
PRPRPLYZ 51¢ EMUCONS 
PRPSW 1F5 EMUCONS 
PRPVSER 1EF EMUCONS 
PSWMSK2 172 RASCONS 
PSWSAVE 168 RASCONS 
PSWSVE 224 RASCONS 
PSWSW 17¢ RASCONS 
PTCHAREA 3c8 RASCONS 
PUBINDX A COMTAB 
QLIST 59C EMUCONS 
ONAME 5A8 EMUCONS 
RAS ART 20 1A0 RASCONS 
RASCCW 2Cc4 RASCONS 
RASCONS 0 RASCONS 
RASDIAG 2C0 RASCONS 
RASFLG1 17E RASCONS 
RASNPCDS 36 RASCONS 
RASNPCUU 40 RASCONS 
RASNPSW1 54 RASCONS 
RASNPSW2 55 RASCONS 
RASNPSW3 56 RASCONS 
RASNPSW4 57 RASCONS 
RASOPCDS 0 RASCONS 
RASOPLEN 8 RASCONS 
RASOTHER 19¢ RASCONS 
RASPC 184 RASCONS 
RASPCSW 17F RASCONS 
RASPSWSV 160 RASCONS 
RASSNPNO 34 RASCONS 
RASSVC 190 RASCONS 
RASTRCDS 14 RASCONS 
RASTRCMX Cc RASCONS 
RASTRCNO 10 RASCONS 
RASTRCNX E RASCONS 
RASTRCTB 8 RASCONS 
RAS TRCUU 1c RASCONS 
RASTRLEN A RASCONS 
RASTRSVC 2C8 RASCONS 
RASTRSW1 30 RASCONS 
RASTRSW2 31 RASCONS 
RASTRSW3 32 RASCONS 
RASTRSW4 33 RASCONS 
REGA 150 EMUCONS 
REGB 154 EMUCONS 
REGC 158 EMUCONS 
REGD 15¢C EMUCONS 
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Field Name Location Data Area 
REGE 160 EMUCONS 
REGF 164 EMUCONS 
REGSAV 128 EMUCONS 
REGSAVE 1c4 EMUCONS 
REGO 128 EMUCONS 
REG1 12C EMUCONS 
REG2 130 EMUCONS 
REG3 134 EMUCONS 
REGY 138 EMUCONS 
REG5 13C EMUCONS 
REG6 140 EMUCONS 
REG7 144 EMUCONS 
REG8 148 EMUCONS 
REGY 14c¢ EMUCONS 
RESCUU Ce EMUCONS 
RESOFST D2 EMUCONS 
RFACTOR 510 EMUCONS 
RNAME 5B0 EMUCONS 
RNMBIN 5B3 EMUCONS 
RNMCUU 5B0 EMUCONS 
RNMELEN y EMUCONS 
SCANB3BEG 244 EMUCONS 
SCANCHR 240 EMUCONS 
SCANEND 23C EMUCONS 
SCANLNG 248 EMUCONS 
SCANSTP 243 EMUCONS 
SCANT BL 23C EMUCONS 
SECOND 1B4 EMUCONS 
SECONDA 1B8 EMUCONS 
SEKADR 3FC Open table 
SNPCUULN A RASCONS 
SNPLEN 8 RASCONS 
SNPNO 21C RASCONS 
SRCHKEY 409 Open table 
STAEREGS 4u70 EMUCONS 
STAERTN 474 EMUCONS 
STCKALDR 620 EMUCONS 
STGBUF 18 STGCON 
STGCCW 1c STGCON 
STGCHFLSG 10 STGCON 
STGCON 38 COMTAB 
STGCSW 9 STGCON 
STGCUU 24 STGCON 
STGDLM 20 STGCON 
STGCTP 18 STGCON 
STGFLG 0 STGCON 
STGFLG2 27 STGCON 
STGINTR AC EMUCONS 
STGLNCNT 4 STGCON 
STGLNPTR 6 STGCON 
STGMAX 12 STGCON 
STGOPCD 14 STGCON 
STGSENO 2 STGCON 
STGSEN 1 3 ST GCON 
STGWK1 1 STGCON 
STORG SW 17D RASCONS 
STPTBL 24C EMUCONS 
SVCCHN 1A8 RASCONS 
SVCEXAD 1B0 RASCONS 
SVCEXRTN 1c0 RASCONS 
S370SW 604 EMUCONS 
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TAFLAG1 
TAFLAG2 
TAFLAG3 
TAFLAG4 
TDELTA 
TEBLEN 
TEBTAB 
TEBV 
TIMEIND 
TIMERECB 
TIOEDDNM 
TIOEFSRT 
TIOELNGH 
TIOTADR 
TRCDLEN 
TRCLZEN 
TRNSFLD 
TRNSFLOA 
TRNSFLD1 
TRNSFLD3 
TRNSFLD4& 
TRNSFLD5 
TSBLEN 
TYPSAVE 
UCBTYP 
VIIVCON 
VOLLABI 
VOLNO 
VOLSERNO 
VOLVTOC 
WKAREA 
WTOECB 
WTORECB 
XLIST 
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ISBLK 
ISBLK 
ISBLK 
ISBLK 
EMUCONS 
TERV 

TEB 

TEBV 
EMUCONS 
EMIJCONS 
TLOT 
TIOT 
TIO™ 
=SMUCONS 
RASCONS 
RASCONS 
EMUCONS 
EMUCONS 
EMUCONS 
EMUCONS 
EMUCONS 
EMUCONS 
TEBV 
RASCONS 
UCB 
RASCONS 
VOL label 
VOL label 
VOL label 
VOL label 
EMUCONS 
EMUCONS 
EMUCONS 
EMUCONS 
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389 


DATA AREAS 


C 


Data Area Relationships 


Data Area Layouts 
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DATA AREA RELATIONSHIPS 


The major paths by which Emulator routines can reach specific data areas are — 
shown in Figures 33, 34, and 35. 
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Communications Table (COMTAB) (3) DCB 


The CSECT IIVCON contains data constants common to most Emulator modules. 
Bytes X‘98-9B’ labeled ACOMTAB point to COMTAB. 

Bytes X‘9C-9F’ labeled ADOSPUB point to the DOS PUB table. 

Bytes X’B8-BB’ labeled POSTECB point to the post ECB list. 

Bytes X‘E8-EB’ labeled ECBLIST point to the ECB pointer table. 

Bytes X‘F8-FB‘ labeled ISSKTAB point to the ISK/SSK table. 

Bytes X‘'1D0-1D3' labeled AOSPUB point to the OS PUB table. 


A one-to-one relationship exists between the DOS PUB table and the OS PUB table. An ItVCON 
X‘FF' in the last byte of this tabie acts as a table delimiter. 


An OS PUB entry specifies a COMTAB entry number An X‘FF’ entry indicates that no 
COMTAB entry exists for a DOS PUB tabie entry. 


The communications table has one 88-byte entry for every device allocated to emulation 
plus an entry for SYSLOG. 


The byte labeled PUBINDX is an index tnto the DOS PUB table where the PUB entry 
for this DOS device can be found. 


Bytes X'4C-4F" labeled DCBPTR point to the appropriate DCB. Post ECB list The first byte points toa COMTAB entry. The second byte contains the condition code 


For every data set to be processed by a program, there is a corresponding data control from the ECB when it was last posted. 


block to indicate its current use. ECB Pointer table This table is a list of 4-byte addresses to the ECBs for the devices being used {or DOS 


This register points to the first byte of IIVCON. emulation plus addresses for SYSLOG and three special ECBs. 
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This table has a 1-byte entry for each 2K block of DOS storage that contains the 
appropriate protect key for each block. 
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Register 11 (1) 
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FIDBLK chain 


24 0 FIDNXT 
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FIDCTXTN 


This register points to the first byte of II VCON. 
Bytes X°98-9B' (labeled ACOMTAB) point to COMTAB. 
Bytes X‘'10C-10F’ (labeled DSFIDBLK) point to a FIDBLK in (3) 


the FIDBLK chain. 

Bytes X'0-3’ (labeled FIDNXT in each FIDBLK) point to the COMTAB (3) 
following FIDBLK in the chain. 

Bytes X‘4-7' (labeled FIDPRV in each FIDBLK) point toa 
previous F!DBLK in the chain. (This field is zero in the first 

FIDBLK in the chain.) 


Bytes X‘8-B’ (labeled FIDCT XTN in each FIDBLK) point to 
the appropriate COMTAB extension for the data set in the chain 
of COMTAB extensions. 


COMTAB 
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ee ° FIDPRV 
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FIDCTXTN Bs 
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COMTAB extension chain 


Bytes X‘4-7’ (labeled CTECHPTR in each COMTAB extension) 
point to the next COMTAB extension on this device. 


Bytes X‘8-B’ (labeled CTDCBPTR in each COMTAB extension) 
point to the DCB for this data set. 

Bytes X'4-7' (labeled CTEXTPTR in each COMTAB) point to 
the COMTAB extension for this entry. 


Bytes X’4C-4F‘ (labeled DCBPTR in each COMTAB) point to 
the DCB for this data set. 
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COMTAB extension chain 


© \ 


ISBLK chain 


Subtask register 
save area 


_ CTECHPTR E 
; CTDCBPTR 


FIDPRV 


4 48 FIDNXT 


4c 
: FIDPRV This portion of an 


ISBLK is the same 
asa FIDBLK 


This register points to the first byte of IIVCON. 
Bytes X‘98-9B' (labeled ACOMTAB) point to COMTAB. 
Bytes X‘110-113' {labeled ISFIDBLK) point to FIDBLK in the 


ISBLK., 
Extension 


Bytes X‘48-4B’ (labeled FIDNXT in each FIDBLK in the ISBLK) 


Bytes X’50-53’ (labeled FIDCTXTN in each FIDBLK) point to 
the appropriate COMTAB extension in the chain of COMTAB 
extensions. 


Bytes X'4-7° (labeled CTECHPTR in each COMTAB extension) 
point to the next COMTAB extension on this device. 


Bytes X‘8-B’ (labeled CTDCBPTR in each COMTAB extension) 


point to the associated ISBLK in the ISBLK chain. 
Bytes X’4C-4F' (labeled FIDPRYV in each FIDBLK) point to the ar : : 
previous FIDBLK in the chain. However, this field in the first COMTAB Bytes X’4-7° (labeled CTEXTPTR in each COMTAB) point to the 


FIDBLK in the chain points to the ISFIDBLK field in I1VCON. COMTAB extensions associated with this volume. 


COMTAB 


point to the following FIDBLK in the chain. 
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DATA AREA LAYOUTS 


This section describes control blocks unique to the Emulator, control blocks 
in the Emulator region that are referenced by both the Emulator and OS, and 
data areas in DOS and OS that are referenced by the Emulator. 


In some cases, major portions of the block not relevant to the functions of 
the Emulator are omitted. In those cases, a reference is made to a publication 
where a more complete description can be found. 


Some of the data areas (for example, the CAW, CSW, and the PSW) are fully 
described in the publication IBM System/360 Principles of Operation. The 
descriptions of those data areas are therefore condensed in this section to 
minimize references to the Principles of Operation publication. 


The symbolic names shown in individual data area fields represent the offset, 
in bytes, from the beginning of a table to the field. Access is gained to 

a specific field by using an instruction in which the beginning address of 
the table (usually contained ina register) is the base address, and the 
symbolic field name represents the displacement. 


There are places where the symbolic field names will differ from the names 
used in other publications. Names used here were taken from Emulator listings 
and where differences exist, a nonemulator program may refer to the field hy 
the other name. (To resolve name differences, compare offsets; if the offsets 
match, the names represent the same field.) 


Usage of the data ar2za fields can be traced in the Emulator listings by first 
locating the symbolic field names in the cross-reference table at the back 

of the listings and then noting where the names are used. Where no symbolic 
name appears ina data area field, the field is probably not referred to hy 
the Emulator. 


The page format used for data area field descriptions is identical to that 
used in the publication System Control Blocks for OS or System Data Areas for 
OS/VS. The field headings and their meanings are: 


FOICIOIIOIOI IO ROI IOIIOI ICICI IOI GIO IOI IOI I i IOI I GI i I IR a kak ake lioir sioak ake ak ate ak ake ake ake ake ate ake afc a ak ak ak ak ak ote fe 
* Bytes and Field Hex. * 


*Offset Alignment Name Dig. Field Description, Contents, Meaning* 
SOIC IOI IGG GIO III IGIOIIOIGI OI GOI IOI IO IR III IOI GK sok Rk ROR a i a teak 


Offset: The numeric address of the field relative to the beginning of the 

data area. The first number is the offset in decimal, followed (in parentheses) 
by the hexadecimal equivalent. 

Example; 16 (10) 


Bytes and Alignment: The size (number of bytes) of the field and its alignment 
relative to the fullword boundary. 
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Examples: 

4 7 a 4-byte field beginning on a word boundary 

a2 - a 2-byte field beginning on a halfword boundary 

awe | = a t-byte field in the low-order byte of a word 

ee - a 3~byte field beginning at the low-order byte of a 


word (and running into the next word) 


Field Name: A name that identifies the field. This column is also used to 
show the bit settings of flag fields, that is, the state of bits in a byte. 
When the columm is used to show the state of bits (0, 1) in a flag byte, it 
is shown as follows: 


ganas ~-.-. The 8 bit positions (0-7) in a byte. For ease of 
scanning, the high-order (left-hand) 4 bits are 
separated from the low-order 4 bits. 


Kawa ees A reference to bit 0. 

Tee. eee- Bit O is on. 

Os dhe eee. Bit O is off. 

oie tas --xx A reference to bits 6 and 7. 


Bit settings that are significant are shown and described. Bit settings that 
are not presently significant are described as reserved bits. Do not use these 
bits because the Operating System may make use of them in the future. 


Hex. dig. (hexadecimal digits): The contents of the field expressed as 
hexadecimal digits. 


Field Description, Contents, Meaning: The use of the field. 


[ Adjust CCW List 


Initialized by: IIVINT 
Modified by: IIVCCW, IIVPCE, IIVABN, IIVADJ, adjust CCW string instruction 
Interrogated by: IIVCCW, IIVSNP, IITVADJ, and adjust CCW string instruction 
Pointer in: EMUCONS and Emulator register 9 + X'40' offset 

| The Adjust CCW list (Figure 36) contains information necessary for modifying 
the data addresses in channel command words so that they address the main- 


storage area assigned to the emulated environment. See the Appendix for 
details. 
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Reserved 


Reserved 


17(11) 


Reserved 


21(15) 


Reserved 


Figure 36. Adjust CCW List 


Adjust CCW List Description 


Bytes and Field 
Offset Alignment Name 


0 (0) 4 
5 (5) 3 
11 (B) joe 
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Signed Adjustment Factor 


Local Limit Address 


Reserved Operation Byte 


Operation Pointer 
CCW Address 


TIC Command Address 


Field Description, Contents, Meaning a 


Signed adjustment factor. This area holds a 
fullword, binary, signed number on a 4096-byte 
boundary (the three low-order hexadecimal digits 
equal 000). This factor is algebraically added 
to the data addresses of the CCWs. A positive 
number is used to adjust local CCW data addresses 
to true addresses; a negative number is used to 
reconvert true data addresses to local addresses. 


Local limit address. This word holds the maximum 
address usable by the emulated DOS programs. 

The address value must be on a 4096-byte boundary 
minus 1 (the three low-order hexadecimal digits 
equal FFF). The adjusted data address computed 
from the CCW data address plus the adjustment 
factor (see above) must fall between address 0 
and the local limit address. 


Operation byte. This field carries the command 
code for CCWs that are data chained together. 

The operation byte is set to the command of the 
first CCW of a data chain and is used to indicate 
direction when computing the extreme data addresses 
of the cCWs that are data chained together. 


Bytes and Field 
offset Alignment Name Field Description, Contents, Meaning 


The field is set to zero when the CCW being 
processed is not data chained. Therefore, a 
nonzero field found upon initialization of an 
instruction indicates that the first CCW to be 
adjusted is part of a chain. 


43 (D) 3 Operation pointer. This word contains the true 
address of the CCW that originated the operation 
byte for the last nonTIC CCW adjusted. 


17 (11) 3 CCW address. This field holds the true address 
of the first CCW of the string. The adjust CCW 
String instruction (see Appendix) adds the 
adjustment factor to the data address portion 
of each CCW in the CCW string until: 


(1) The end of the string has been reached 
{condition code = 0); 


(2) A TIC (transfer in channel) command has been 
encountered (condition code = 1); 


(3) The local storage area specified by the last 
ccW adjusted falls at least partially outside 
the limits of 0 and the local storage limit 
address (condition code = 2); or 


(4) The next CCW to be adjusted falls at least 
partially outside the limits of 0 and the 
local storage limit address or is not located 
on a doubleword boundary {condition code 
= 3). 


Whenever one of these four conditions terminates 
the instruction, the condition code is set and 

the address +8 of the last CCW adjusted is placed 
into the CCW address field. If a data chain was 
in process, the command code and address of the 
CCW containing the command are set in the operatior 
byte and operation pointer fields of this list. 


21(15) 3 TIC command address. If the last CCW adjusted 
was a TIC, this field contains the command address 
from the TIC CCW. 


If the TIC ccW is within a data chain, the 
operation byte and operation pointer fields of 
this list contain the values set for the first 
CCW of the data chain. 


Yf the TIC CCW is not within a data chain, the 
operation byte field of this List is set to zero, 
the CCW address field of this list is set to the 
address +8 of the TIC CCW, and the operation 
pointer field of this list is set to the address 
of the last CCW adjusted before the TIc. 
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Beginning and End Block (BEBLK) 


Initialized by: IIvccw 

Modified/Interrogated by: IIVCCW, IIVSNP 

Pointer in: EMUCONS 

The BEBLK table (Figure 37 Part 1 of 2) in the Emulator routine TIVCCW contains 
an 8-byte entry for each group of CCWs. The first four bytes of an entry 
contain the starting address of a group of CCWs within the CCW chain presently 
being processed by the IIVCCW routine. This starting address will be the 
address of one of the following CCWs (numbers below correspond to numbers in 
Figure 37 Part 2 of 2): 

(1) The first CCW in the CCW chain heing processed. 


(2) The CCW addressed by a TIC CCW (only if that CCW addresses a group of CCWs 
other than the group that the TIC CCW itself terminates). 


G3) The CCW that follows a TIC CCW {only if the TIC CcwW addresses a CCW within 
the group that the TIC CCW itself terminates). 


The end of a group of CCWs is determined by encountering one of the following 
ccCWs (Figure 37 Part 2 of 2): 


(@) a TIC cew. 


(5) The end of the CCW chain (the command chaining and data chaining bits set 
to zero). 


The Last four bytes in each BEBLK table entry contain the address +8 of the 
ccW that terminates the group of CCWs begun at the address contained in the 
First four bytes. 


Beginning CCW Address Ending CCW Address 


+8 


Ending CCW Address 
+8 


Beginning CCW Address 


16(10) 20(14) 


Beginning CCW Address Ending pau Address 


Ending CCW Addr 


Beginning CCW Address 
32(20) 
Beginning CCW Address 


Beginning CCW Address 


Figure 37 (Part 1 of 2). Beginning and End Block (BEBLK) 
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Conceptual illustrations of Beginning CCW Address in BEBLK: 


Conceptual illustrations of Ending CCW Address in BEBLK. 


CCW 
CCW 
CCW 
TIC 


CCW 
CCW (last CCW in chain) 


»>— Beginning/Ending address pointer 
—— TIC command address 


Figure 37 {Part 2 of 2). Beginning and End Block (BEBLK) 


Data Areas 401 


Channel Address Word 


Initialized by: bos J 


Interrogated by: IIVPCE, ITIVLOG, ITIVAWV, IIVscr 
Pointer in: Emulator register 10 (points to DOS storage) + X'48" offset 


The channel address word (Figure 38) is referred to by a channel during 
execution of a start I/O instruction. Tt is the means by which the channel 
can determine the main-storage location from which it should fetch the first 
channel command word (CCW). The channel address word is permanently assigned 
to main-storage location 72. 


DOSCAW 


0(0) 
Protection Address of CCW 


Key 


0 34 78 31 
Bits 


Figure 38. Channel Address Word 


Channel Address Word Description 


Bytes and Field 


Offset Alignment Name Field Description, Contents, Meaning 3 
0 (0) 1 DOSCAW Protection key. In systems having the data set 


protection feature, contains the requestor's 
protection key. Otherwise, contains zeros. 


1(1) 23 The main-storage address of the first channel 
command word (CCW) to be executed. 


Channel Command Word 


Initialized by: DOs 
Modified by: IIVABN, TIVPCE, IIVCCW, IIVADJ, and adjust CCW string instruction 


Interrogated by: TIVLOG, IIVSTG, ITirvewv, TiIvccw, TIVViIoO, IIVCHK, IIVACI, 
TIVADJI 


Pointer in: DOS CCB + X'08' offset 
The channel command word (CCW, Figure 39) indicates to a channel what I/0 
operation it should start. For operations involving data transfer, the CCW 


also indicates the main-storage location into which data is to be placed or 
read from, and how many bytes of data are to be transferred. 
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Data Address 


32 39 40 4748 63 


Figure 39. Channel Command Word 


Channel Canmand Word Description 


Bytes and Field 


offset Alignment Name Field Description, Contents, Meaning 
0 (0) 1 Command code. Specifies the operation to 


be performed. 


141) — Data address, Specifies the main-storage 
location of a data area. Depending upon 
the command code, data is either read from 
or placed into the data area during an I/0 
operation involving data transfer. 


4 (4) 1 TO Se eles Chain-data (CD) flag. The data area 
designated by the next CCW is to be used 
with the current operation. 


O1e6 sks « Chain-command (CC) flag. The operation 
specified by the command code of the next 
ccW is to be initiated on normal completion 
of the current operation. 


Se 1s. acme Suppress-length-indication (SLI) flag. The 
incorrect length status bit in the channel 
status word is not to be set by the channel 
if it detects an incorrect-length condition. 


ra eee Skip flag. Data transfer to main storage 
is to be suppressed. This flag is valid 
only for read, read backward, and sense 


operations. 
woiwe Vetere Program controlled interruption (PCI) flag. 
Not siqnificant to Emulator. 
woes 000 Must be zeros for every CCW except for those 
ccWs specifying a transfer in channel 
operation. 
6 (6) oe Count. Specifies the number of bytes in 


the data area associated with this CCW. 
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Channel Status Word 


Initialized by: Emulator 

Modified by: OS, TIVPCE, IIVSTG, IIVCWV, IIVAWV, IIVPOV, IIVLOG 

Pointer in: Emulator register 10 {points to DOS storage) + X'40* offset 
Interrogated by: IIVPCI, IIVACI 


Explanation: TIIVPCE gets the 7 low-order bytes of the last CSW from the IOBCSW 
field in the IOB and the high-order byte from the COMKEY field of COMTAB and 
places it in the CSW location in DOS storage. It is the CSW in the IOB that 

is modified by OS and the Emulator modules. 


The channel status word (CSW, Figure 40) indicates to a program the status 

of an I/0 device, control unit, channel, and subchannel. The CSW is assigned 
permanently to main-storage location 64. Information is stored in the cSWw 
by a channel after an I/O interruption and also during execution of the start 
I/O, test I/0, and halt I/O instructions. 


DOSCSW 


O 
eee 
Key 


Address of Last CCW + 8 


Bits 


Status 


32 47 48 63 
Bits 


Figure 40. Channel Status Word 
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Channel Status Word Description 


Bytes and Field 


Offset Alignment Name Field Description, Contents, Meaning 
0 (0) 1 XXXX cece Protection key. In systems having the data 


set protection feature, contains the 
requestor's protection key. Otherwise, 
contains zeros. 


eeee 0000 Always zeros. 

1{1) a3 A main-storage address that is eight higher 
than the address of the last executed CCW. 

4 (4) 2 Status byte 1 

lewis: asa Attention 

Se Penes erase Status modifier 

ewe. latete Control unit end 

eee leas Busy 

‘cur eas Channel end 

Sahai Matilaes Device end 

Svaeia, Grae 1s Unit check 

Severe: Jew | Unit exception 


Status byte 2 


Visas! Seerers Program-controlled interruption 
a ee ee Incorrect length 
ey ee eo Program check 
aaras V iuecees Protection check 
a ee Channel data check 
ewiete. eee Channel control check 
Sele. . cae: Wis Interface control check 
eS ee Chaining check 
6 (6) ee. Count. 


The number of bytes of data that remained to 
be transferred after the last CCW was executed. 


Command Control Block 


Initialized by: pos 

Interrogated by: IIVADD, IIVDVS, IIVGR2, LIIVPCE 

Pointer in: DOS register 1 

The DOS command control block (CCB) is used for communication between physical 
Iocs and the prcblem program. A 16-byte field is required for each channel 
program executed by physical Iocs. 

Note in Figure 41 that byte 2, bit 0, is significant to the Emulator. Bit 

O is normally set on at channel end to signify that the I/0 operation was 


completed. Bytes 9-11, also significant to the Emulator, contain the address 
of the CCW associated with this CCB. 
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DOSCCB 


Transmission 
Information 


CCW Address 


2 
Bytes 


Used for Transmitting 
Information Between 


| 

| 

| Physical |OCS and 
| Problem Program 
| 

| 
? 


rocorcr re 


“ Byte 2 (Set by Problem Program) ae 


Traffic Bit 


(Wait) 


0 


Bits 


Figure 41. Command Control Block Field Used by the Emulator 


Communications Table ‘ 


Initialized by: IIVINT 

Modified by: IIVCPN, IIVPCE, IIVSTG, IIVAWV, IIVABN, IIVCHK, IIVINT 
Interrogated by: IIVRTE, IIVPRP, IGG019S1, IGGO19SA, IIVGR2, IIVACI, IIVIN2 
Pointer in: EMUCONS 

The communications table (COMTAB, Figure 42) has one entry for every device 


allocated to emulation plus an entry for SYSLOG. Each entry is formatted as 
illustrated in Figure 42. 
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COMTAB 


Cc ECB 


4(4) 
CTEXTPTR 


8(8) 10(A) 11(B) 

DOSCUU PUBINDX DEVTYP 
12(C) 14(E) 

OSCUU DOSBIN 


16(10) 18(12) 19(13) 
OSBIN CTFLAG CTFLAG2 


20(14) 21(15) 
CTFLAG3 CTFLAG4 


32(20) 
COMKEY COMCCWSA 


36(24) 


( COMCAW 


40(28) 41(29) 
COMFMSK | EGR 


er ere eee 


48 (30) 49(31) 


EMUCCW2 
CCW2ADDR 


56 (38) 
lOB/STGCON 


76(4C) 
DCBPTR 


Diss F 


Figure 42. Communications Table 


C 
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Communications Table Description 


Offset 
Q (0) 


4 (4) 


8 (8) 


10 (A) 


11 (B) 


12(C) 
14(E) 
16 (10) 


18 (12) 


19 (13) 


20 (14) 


Bytes and Field 


Alignment Name 


4 


4 


east 


ECB 


CTEXTPTR 


DOSCU 


U 


PUBINDX 


DEVTY 


OSCUU 


DOSBI 


OSBIN 


Pp 


N 


CTFLAG 


Tees 
ole. 
er 
evel 


; eee 
es dace 


al br 


wae 


CTFLAG2 


lees 
2 le- 
eel. 
eos l 


@eees 
ewe @ 
=2see 8 


: er 
~le6 


a 


eu 


CTFLAG3 


yg eae 


ee ae 
sae le 
Pe | 
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Aka 
Sere 


Pe 


Field Description, Contents, Meaning 
The actual ECB for this device. 


The pointer to the COMTAB extension for this 


entry. 


The DOS channel and unit address as known by the 


POS supervisor. 


The index into the DOS-PUB table where the PUB 
entry for this DOS device can be found. The first 


PUB entry is index value zero. 


The one-byte DOS device type as given in the DOS- 


PUB table. 


The OS channel and unit address. 


The DOS 2321 bin number from the DDname. 


The OS 2321 bin number from the OCB. 
Communications flaq. 


Entry for a staged device. 

Entry for DOS SYSLOG. 

Check I/0 to test I/O exit flag. 
Device end flag. 

Sense switch. 

Device in use 

Nonoperational flag. 

Device is open. 


Communications flag 2. 


Tape device. 

Direct-access device. 
Optical character reader. 
Staged SYSIN device. 

Staged SYSOUT device. 

2321 device. 

Do not suppress error retry. 
File protection flag. 


communications flag 3 


Use OS error recovery procedures for 
I/O request. 

Shared volume indicator. 

Indexed sequential data set. 

User label swap switch. 
Telecommunications device. 
Seven-track tape unit. 

NOP-issued flag. 

Stand-alone seek flag. 


this 


Communications Table Description (Continued) 


offset 


2115) 


22 (16) 


22 (16) 


32 (20) 


33 (21) 


36 (24) 


40 (28) 


40 (28) 


48 (30) 


49 (31) 


56 (38) 


76 (4c) 


COMTAB Extension 


Initialized by: 


Bytes and Field 
Alignment Name 


1 


2210 


40) 


m 


Modified by: 


Interrogated by: 


Pointer in: 


TIVPCE, 


COMTAB 


CTFLAG4 


: 5 and 
elee ence 
sels ence 
woes Tene 


eveXk XX 


ess & eae Ns 


CTXTNSAV 
or 
CTULEXT 


COMKEY 


COMCCWSA 


COMCAW 


COMFMSK 
or 

EMUCCW 1 
EMUCCW2 


CCW2ADDR 


IOB/ 
STGCON 


DCBPTR 


IIVINT 


IIVDVS, ITIVIS 


Field Description, Contents, Meaning 


Communications flag 4. 

Disposition is SHAR. 

Not ready mask. 

DOS resident device. 

Restore DEB extents indicator. 

Not used. 

Stand-alone CCW (not chained) set mode issued. 


Extent from DEB at SIO time. 


User label extent at DOS open time. 


Save area used to pass storage protection key 
at SIO time to DOS {during I/O interruption time). 


Save area for CCW command address; nonzero value 
implies NOP has been issued by Emulator. 


Pointer to CCW command chain to be adjusted from 
local to true address. 


File mask for DOS DASD. 


Emulator area for set-mode CCW for tape. 

Emulator area for TIC CCW for tape commands. 

The first three bytes contain the address portion 
of TIC ccW for tape; the last four bytes, the 
remainder of the TIC CCW. 

The actual IOB (including a 4-byte field called 
CCBPTR, the DCB pointer) or STGCON in the case 

of a staged device. 


(See IOB/STGCON field) 


TIVGR2, IIVDVS, IIVIS 


The COMTAB extension {CTEXT, Figure 43) has one entry for every file residing 


on a Shared direct-acce2ss volume. 
accass device sharing, 
is related to the COMTAB entry. 


Figure 43. 


If a COMTAB entry is marked for direct- 


then at least one COMTAB extension entry exists that 


Each entry is formatted as illustrated in 
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CTEXT 


2(2) 
CTEXTFLG CTDCBUC Unused 
4(4) 
CTECHPTR 


8(8) 
CTDCBPTR 


CTDDNAME 


20(14) 


CTDSNAME 
63(3F ) 


Figure 43. COMTAB Extension 


COMTAB Extension Description 


Bytes and Field 


Offset Alignment Name Field Description, Contents, Meaning 
0 (0) 1 CTEXTFLG COMTAB extension flag. 


lees wee. Indexed sequential data set. 
etee eeeve End of CTEXT chain indicator. 
oeXX xXxxx Not used. 


1(1) Ps | CTDCBUC DCB use count. 

4 (4) 4 CTECHPTR Pointer to the next CCMTAB extension on this 
device. 

8 (8) 4 CTDCBPTR Pointer to the DCB for this data set. 

12 (C) 8 CTDDNAME DD (data definition) name. 

20 (14) ua CTDSNAME DS (data set) name. 


DASD Label (DLBL) 


Initialized by: DOS 

Modified by: DOS, IIVDVS, IIVIS 

Interrogated by: IIVGR2, IIVDVS, IIVIS, DOS 

Pointer in: DOS open table 

The DLBL represents the internal format of a DOS DLBL extent statement read 
from the label cylinder by DOS OPEN phases. Figure 44 shows the fields in 


the DLBL that are significant to the Emulator and the field description tells 
which modules modify or interrogate each field. 
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a 


0(0) 
DLBL—Extent 
Indicator 


8(8) 


DA/IS Switch 
File ID 


54 (36) 


Unused 


File Serial Number 


62(3E) 
Creation Date 


Creation Date Expiration Date 
(continued) 


Retention Period Open Code 


Volume Serial Number 


90(5A) 91(5B) 


Extent Type Extent Sequence 
Number 


Extent Lower Limit 


Extent Upper Limit 


102(66) 103(67) 


Logical (Symbolic) Unit Address 2321 Lower Cell 2321 Upper Cell 


Figure 48. =DASD Label 
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DASD Label Description 


offset 


0 (0) 


8 (8) 


99) 


54 (36) 


60(3C) 


63 (3E) 


65{41) 


68 (44) 


70 (46) 


84 (54) 


412 


Bytes and Field 
Alignment Name 


1 


1 


Hy 


DLBL- 
EXTENT 


Teen cove 
alee evce 
eels cone 
oon] sees 
wove lees 
Sites: sa lee 
eaee cole 


@eees eooaX 


Field Description, Contents, Meaning 
SD (sequential disk) 


Next extent on a new pack. 

Last extent. 

Bypass extent. 

New volume on same unit. 

Extent Limits omitted. 

Extent converted to DASD address. 
No EXTENT/XTENT card. 

Not used. 


For direct access or indexed sequential file 
Management system, this byte indicates 

the number of extents. Modified/interrogated 
by IIVDVS. 


CDA/IS switch 


RMKX 2 aKX 


we@etwvee 1eex 


@eaeere «lacs 


File ID 


File 
serial 
number 
Volume 
sequence 
number 


Creation 
date 


Expira- 
tion date 


Retention 
period 


Open code 


Volume 
serial 
number 
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Not used. 

Extent limits omitted. 

Extent converted to DASD address. 
Modified hy IIVDVS. 


File identifier including generation and version 
numbers. If field is missing on DLBL card, file 
name padded with blanks is inserted. Interrogated 
by IIVGR2. 


Vclume serial number from first extent. 
Modified by IIVDVsS. 


Always initialized to x'0001'. 
Modified by IIVDVS. 


Initialized with 3 bytes of X*00'. Modified by 
IIVDVS. 


If date is in the form YYDDD, it is converted to 
YDD. If date is in retention period form, 1 to 4 
characters, the field is padded with binary zeros. 
Modified by IIVDVS. 


Converted to a 2-byte number and inserted in this 
field. Modified by IIVDVS. 


DLBL type: 

S = sequential 

D = direct access | 

C or E = indexed sequential 
file management system where: 
C = load create function 

E = load extend function 
Interrogated by IIVIS. 


Volume serial number for extent. 
Modified by IIVDVS. 


Offset 


90 (5A) 


91(5B) 


92(5C) 


96 (60) 


100 (64) 


102 (66) 


103 (67) 


Bytes and Field 
Alignment Name 


1 


1 


1 


Extent 
Type 


Extent 


sequence 


number 


Extent 
lower 
limit 
and 
extent 
upper 
Limit 


Logical 
(sym- 
bolic) 
unit 
address 


2321 
lower 
cell 


2321 
upper 
cell 


Field Description, Contents, Meaning 


Same codes as in Format 1 label: 


X'00* = next three fields do not indicate any extent. 

X*O1" = prime data area ({ISFMS) or consecutive area, 
etc. (that is, the extent containing the 
user's data records). 

X*02' = Overflow area of an ISFMS file. 

X'Q4at = Cylinder index or master index 
of an ISFMS file. 

X*4Q' = User label track area. 

X*8n' = Shared cylinder indicator, 


where n = 1, 2, or 4. 
Modified by IIVDVS. 


Number of extents as determined by the 
extent card sequence. Modified by IIVDVS. 


Before the OPEN, DLBL/EXTENT informa- 
tion is in the relative track form of 
HHNNT followed by three bytes of 
binary zeros. 

HH = Relative (to 0) start address in 
tracks. 

Number of tracks. 

0 or upper track number for split 
cylinder in SD files. 

Following an OPEN on DLBL/EXTENT cards, 
or whenever DLAB/XTENT cards are used, 
the extent lower and upper limits are 
each in the CCHH format. Modified by TIVDVS. 


NN 
T 


This 2-byte field identifies the logical 
unit with the same code as that used in 


a CCB. The first byte identifies the 
unit class: 

X#00" = System logical unit 

X'O01' = Programmer logical unit 


The second byte identifies the logical 
unit within its class. Thus xX'0003°* 
denotes SYSLST and X*0103? denotes 

SYS003. Interrogated by IIVGR2 and IIVDVS. 


2321 extent lower and upper cell limit. 


This 2-byte field contains zeros for 
2311/2314/2319 disk. Modified by IIVDVS. 
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Data Control Block 


Initialized by: ITIVOPN {EXCP, QTAM, BTAM), IIVIS (ISAM), TIVDVS 
Defined by: IIVRAS (BSAM) 


Modified/interrogated by: IIVSTG, IIVINT, IIVIN2, IIVOPN, IIVPCE (EXCP, 
QSAM, BTAM), IIVIS (ISAM), IIVSNP {(BSAM) 


Pointer in: IOB, COMTAB extension 


Data control blocks (DCBs) describe the current use of a data set. For every 
data set to be processed ty a program, there is a corresponding DCB. 


The foundation sections serve the same purpose in all DCBs although the formats 
may vary Slightly for different access method routines. Although they are 
waintained primarily by data management routines, certain fields in the DCBs 

do contain a limited amount of information maintained or referred to by the 
Emulator. Figure 45 illustrates the format of this DCB. Descriptions of the 
fields follow the illustration. 


Device Interface (ISAM only) 


16(10) 
DCBKEYLE 


Foundation Extension 


Unused DCBEODAD 
36(24) 

DCBRECFM Unused 
Foundation 
ii Before Open : 
| 40(28) 
| DCBDDNAM , 
| | 
! 48(30) | 
l DCBOFLGS Unused DCBMACR | 
| I 
| After Open | 
| Jaa(2c) l 
| DCBIFLGS Unused | 
! | 
LL 


Figure 45 (Part 1 of 2). Data Control Block Fields Used by the Emulator 
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Access Method Interface — ISAM, BSAM, QSAM 
52(34) 53(35) 


DCBOPTCD DCBMAC Unused 


DCBSYNAD 


60(3C) 
DCBRKP DCBBLKSI 


80 (50) 


DCBEXCD1 DCBEXCD2 DCBLRECL 


148(95) 


DCBTDC Unused 


152(98) 
DCBRORG3 


156(9C) 
DCBNREC 


184(B8) DCBLPDA 


Unused DCBRORG2 


214(D6) 
Unused DCBNOREC 


DCBRORG1 Unused 


Figure 45 (Part 2 of 2). Data Control Block Fields Used by the Emulator 
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Data Control Block Descrirtion 


Offset 
16 (10) 
33(21) 
36 (24) 


40 (28) 


Qi (2C) 


48 (30) 


$0 (32) 
52 134) 
53 (35) 
56 (38) 
or 

57 (39) 
60 (3C) 
62 (35) 
80 (50) 
81(51) 


82 (52) 


148 (95) 


152 (98) 


156 (9C) 


184 (B8) 


206 (CE) 


214 (D6) 


224 (E0) 


Bytes and Field 
Alignment Name 


DCBKEYLE 
DCBEOCAL 
CCBRECEM 


CCBDDNAM 
DCBIFLGS 
DCBOFLGS 


DCEMACR 
DC BOPTCD 


DCBMAC 
DCBSYNAD 
DCBSYNAD 
DCBRKP 
BDCBBLKSI 
CCBEXCD 1 


DCBEXCD2 


DCBLRECL 


CDCBTDC 


DCBRORG3 
DCBNREC 
DCBLPDA 
DCBRORG2 
DC BNOREC 


DCBRORG1 
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Field De 


scription, Contents, Meaning 


Kev length (used by ISAM). 


EFODAD ex 


it address (used by ISAM and QSAM). 


Record format {used by ISAM). 


DD statement data set name (used by IIVINT, 


TIVIN2, 


Permanen 


TIVCPN and TSAM). 


t error condition is indicated when 


Dits 9 ani 1 are on {used by EXCP). 


Successful open is indicate’ when bit 3 is 


on {used 


by IIVOPN and ISAM). 


Macro instruction code (used by ISAM). 


Option code (used by ISAM). 


Extension of the macro instruction operation 


code fie 


ld (used by ISAM). 


SYNAD exit address (used by ISAM). 


Staged I/0 SYNAD exit address {used by QSAM). 


Relative 


key position {used by ISAM). 


Blocksize {used by ISAM and BSAM). 


Condition flags {used by ISAM). 


conditio 


Logical 
records 


n flags (used by ISAM). 


record length for variable length 
(used by ISAM, BSAM, and QSAM). 


Tag deleticn count (used by ISAM). 


Count of 


accesses to overflow records other 


than the first (used by TSAM). 


Number of logical records in prime data area 


{used by ISAM). 


Direct-access address of last prime data 
record in prime data area (used by ISAM). 


Number of tracks left in overflow area (used 


by ISAM) 


Number of logical records in overflow area 
(used by ISAM). 


Number of full cylinder overflow areas (used 


by ISAM) 


J 


Data Event Control Block -- BISAM 


Initialized by: IIVIS 


Modified/interrogated by: 


Pointer ins 


IIvis 


Register 1 at WRITE and CHECK time 


The data event control block (DECB) is created when a READ or WRITE macro 


instruction is expanded. 


It contains information about the input or output 


operation requested by the macro instruction. Figure 46 shows the DECB fields 
used in BISAM that are significant to the Emulator. 


Figure 46. 


DECBEXC1 


Data Event Control Block -- 


Offset 


8 (8) 


12 (C) 


16 (10) 


20(14) 


24 (18) 


Bytes and Field 
Alignment Name 


4 DECBDCBA 
4 DECBAREA 
4 DECBLOGR 
4 DECBKEY 

1 DECBEXC1 


lewe cece 
elec seve 
eole esce 
wool coe 
exes Teer 
coos we lee 
@eeeos wae Ve 


eae@ese ee | 


DECBDCBA 


DECBAREA 


DECBLOGR 


DECBKEY 


DECBE XC2 


Data Event Control Block -- BISAM Fields Used by the Emulator 


BISAM Description 


Field Description, Contents, Meaning 


Address of the DCB to which this I/O request is 
related. 


Address of the area in storage for the record. 


Address of the logical record {also used by IIvis 
in QISAM mode to store the current logical record). 


Address of the key portion of the record. 
Exceptional condition code. 


Record not found. 

Record length check. 

Space not found in which to add a record. 
Invalid request. 

Uncorrectable I/O error. 

Unreachable block. 

Overflow record. 

Duplicate record presented for inclusion 
in the data set. 
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Bytes and Field 


Offset Alignment Name Field Description, Contents, Meaning 
25 (19) a1 DECBEXC2 Exceptional condition code. 


ecese eels Execution of the last channel program 

was instituted ky an asynchronous routine. 
ecese eve 1 Previous macro instruction was READ KU. 
XXXX XX.. Reserved bits. 


Data Extent Block 


Initialized by: os 

Modified by: IGG019SA 

Interrogated by: IIVOPN, IIVDVS, IIVPCE 

Pointer ins CCE 

The data extent block (TEB) contains an extension of information in the data 
control block (CCB). Every DEB is associated with a DCB, and the two point 
to each other. The DEE ccntains information concerning the physical 
characteristics of a data set. 


Each DEB consists of one 32-byte base plus: 


e One 4-byte extension if the data set is to be processed on unit-record 
or magnetic tape devices. 


e One 16-byte extension for each extent if the data set is to be processed 
On a direct-access device. 


Figure 47 shows the DEB fields used by the Emulator. A complete description 


of the DEB is contained in the publication System Control Blocks for OS or 
System Data Areas for OS/VS. 
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Appendage Table’ 
—36(—24) 
DEBEOEA 


-32(-20) 


DEBSIOA 


~24(-18) 
DEBCEA 


-20(-14) 
DEBXCEA 


Direct-Access Storage Device Section ” 
+32(+20) 
DEBDVMOD Unused 


+36(+24) +38 (+26) 
DEBBINUM DEBSTRCC 


+40(+ 28) +42(+2A) 
DEBSTRHH DEBENDCC 


+44(+2C) +46(+2E) 
DEBENDHH DEBNMT RK 


' The Emulator includes the start-|/O appendage, channel-end appendage, and abnormal-end appendage routines. 


2 
The start-1/O appendage modifies these fields to extend the extent to cover the whole DASD volume. 


Figure 47. Data Extent Block (Ordinary) Fields Used by the Emulator 


Data Extent Block Description 


Bytes and Field 
Offset Alignment Name Field Description, Contents, Meaning 


APPENDAGE TABLE 


—-36(-24) 4 DEBFOFA Address of the end-of-extent appendage 
-32(-20) 4 DEBSIOA Address of the start I/O appendage routine. 
-24(-18) 4 DEBCEA Address of the channel end appendage routine. 
-20(-14) a DEBXCEA Address of the abnormal end appendage routine. 


DIRECT-ACCESS STORAGE DEVICES 


4#32(420) 1 DEBDVMOD Device modifier: file mask 
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Offset 
+36 (+24) 
+38 (+26) 


+40 (428) 


+42 (+2A) 


+44 (4 2C) 


+46 (4+2E) 


Bytes and Field 
Aliqnment Name 


DEBBINUM 
DEBSTRCC 


DEBSTRHHA 


DEBENDCC 


DEBENDHA 


DEBNMTRK 


Field Description, Contents, Meaning 


Bin number. 
Cylinder address 


Read/write track 
extent limit. 


Cylinder address 


Read/write track 
limit. 


Number of tracks 


for the start of an extent limit. 


address for the start of an 


for the end of an extent limit. 


address for the end of an extent 


allocated to a given extent. 


Data Set Control Block ~- Identifier (Format 1) 


Initialized by: 


Modified by: 


Interrogated by: 


Located in: 


DOS 


oS, DOS, IIVDVS, 


OS space allocation routine or DOS open routine 


IIVVIO, IIVOPN 


This data set control block (DSCB) describes the characteristics and up to 
Figure 48 shows the format of the fields of a 


three extents of a data set. 
format 1 DSCB that are significant to the Emulator. 


follow the illustration. 


DS1FMTID 


Unused 


Figure 48. 


93(5D) 


DS1DSIND 


Unused 


Unused 
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DS1PTRDS 


Descriptions of the fields 


Unused 


135(87) 


139(8B) 


Data Set Control Block -- Identifier (Format 1) Fields 
Used by the Emulator 


J 


Page of GY26-3741 
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Data Set Control Block -- Format 1 Description 


Bytes and Field 
Offset Alignment Name Field Description, Contents, Meaning 


44 (2C) 1 DS1tFMTID Format identifier; hexadecimal F1 
identifies this as a format 1 DSCB. 


93 (5D) ol DSIDSIND Data set indicators. 

1... eee- This is the last volume on which this 
data set normally resides 

eet. «2e- Block length must always be a multiple 
of 8 bytes. 

oeeX oX.. Data set security. 

2--1 .0.. Password is requested to read or write. 

o+e1 2.1.2. Password is required to write but not 
to read. 

-X.. X.xx Reserved bits. 


135(87) ...5 DSIPTRDS Pointer to an index (format 2) DSCB, if data set 
has IS organization, or pointer to an extension 
(format 3) DSCB if data set has sequential or 
direct organization and more than 3 extents. 
This pointer has the format CCHHR. Contains 
kinary zeros if no additional DSCB is rointed 
to. 


Se a er EO 


Initialized by: OS space allocation routine or DOS open routine 

Modified by: OS, DOS 

Interrogated by: OS, DOS, IIVDVS, IIVVIC, TIVOPN 

Pointer in: DSCB -- identifier (format 1) 

This data set control block (DSCB) describes up to 13 additional extents that 
cannot be described in an identifier (format 1) DSCRB. All fields are 
Significant to the Emulator. It is pointed to by an identifier (format 1) 


CSCB. (For format see System Control Blocks for OS or System Data Areas for 
OS/VS.) 


Data Set Control Block -- VTOC (Format 4) 


Initialized by: volume-initializing utilities 

Modified by: OS, DOS 

Interrogated by: OS, DOS, IIVOPN 

Identified by: A 44-hyte entry of xK'04! 

This data set control block (DSCB) describes the volume table of contents 
(vVTOC) data set. It is always the first DSCB in the VTOC. Figure 49 shows 


the format of the fields a VTOC (format 4) DSCB that are significant to the 
Emulator. Descriptions of the fields follow the illustration. 
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O(0) 


Padding Bytes 


DS4DSREC 


Device Constants 


fsotscr | 


74\4A) — OsaDEVDT 


105(69) 


DS4VTOCE 


115(73) 


139(8B) | 


Figure 49. Data Set COntrol Block -- VTOC (Format 4) Fields Used by the 
Emulator 
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Data Set Control Block -- Format 4 Description 


Bytes and Field 


offset 


0 (0) ay 


50 (32) eel 


58 (3A) | 


TU(HA) =o a 1 


105(69) 10 


105 (69) 


106 {6A) 


Alignment Name 


{Padding 
Bytes) 


DS4DSREC 


DSavTocr 


Ngee a2 @ewee 


sew o ee 


DS4DEVDT 


DS4VTOCE 


Byte 1 


Byte 2 


Hex. 


Diq, Field Description, Contents, Meaning 


00 


01 


02 
04 
40 


80 


81 


Hexadecimal 04 in each byte. 


Number of available free VTOC record 


(format 0) DSCBs in the VTOC. 
vToc indicators. 


Either no free space (format 5) 
DSCBs exist, or they do not 
reflect the true status Of the 
volume. 

Accurate free space and shared 
extent (format 5 and 6) DSCBs 


now exist, and bit 0 has been turned 


off. This volume may contain data 
sets produced by the Disk Operating 
System; the Operating 

System access methods may not 

ke able to process these data 

sets. 

A DACSM function has been pre- 
maturely terminated. Possible 

VTOC errors exist. 

(Reserved bits) 


Number of full DSCBs that can be 
contained on one track ({44-byte 
key plus 96-byte data length). 


Extent description of the VTOC. 
Data set extent type indicator. 


Following 9 bytes do not indicate 
any extent. 

The extent contains the data blocks 
(user's blocks) or is a prime area 
for indexed sequential data sets). 
The extent is an overflow area (for 
indexed sequential data sets only). 
The extent is an index area (for 
indexed sequential data sets only). 
The first extent description 
describes the user label extent. 
The extent described is sharing one 
or more cylinders with one or more 
data sets. 

The extent described begins and 
ends on cylinder boundaries, that 
is, the extent is composed of one 
Or more cylinders. 


Extent sequence number (M) 
Uniquely identifies each separate 


extent on a given volume for a 
data set. For all organizations 


Nata Areas 
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Bytes and Field Hex. 
Offset Alignment Name Dig. Field Description, Contnets, Meaning 


but indexed sequential, the first 
extent of the data set on each 
volume is identified with zero 

in this field. 


The first extent on each volume 
of an indexed sequential data set 
is identified with a value of one 
in the field. 


Additional extents on the volume 
are identified with sequentially 
increasing binary values. This 
field is always zero for an 
extent field pointing to a user 
label track. 


107 {6B) Bytes 3-6 Lower limit of this extent (CCHH) 
contains the cylinder and the 
track address specifying the 
starting point of this extent. 

111 (6F) Bytes 7-10 Ypper limit of this extent (CCHH) 
Contains the cylinder and track 


address specifying the ending 
point of this extent. 


Diagnostic Block (DIAG Block) 


Initialized by: IIVRcP 

Modified by: IIVRCP, IIVRCW 

Interrogated by: IIVRCW, IIVRCP 

Pointer in: RASCONS (RASCIAG) 

The diagnostic block (Figure 50) is used to adjust and readjust the data address 


portion of the CCWs from DOS lccal addresses to OS true addresses, then back 
to DOS local addresses. 
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0(0) 
DIAGNXT 
C 4(4) 6(6) 
DIAGCUU DIAGFLAG Unused 


8(8) 
DIAGBUF 

Figure 50. Diagnostic Block 
Diagnostic Block Description 

Bytes and Field 
Offset Alignment Name Field Description, Contents, Meaning 
0 (0) 4 DIAGNXT Pointer to the next diagnostic block. 
44a) 2 DIAGCUU The DOS cuu for the channel program. 
6 (6) 1 DIAGFLAG X'80' if relocation of CCWs is done. 
8 (8) 1048 DIAGBUE Buffer area for the CCWs. 


DTFIS ADD-RETRVE-ADDRTR and DTFIS Load Tables 


Initialized by: JIIvIs 

Modified by: IIVIS 

Interrogated by: TIVIS, TIVGR2 

Pointer in: DCS register 1 when a DOS I/O macro is issued 

When the DTFIS (define the file for indexed sequential) macro instruction is 
encountered at assembly time, the assembler builds a DTF takle tailored to 
the DTF parameters. The table contains: 


* A device CCR. 


* A V-type statement used by the Linkage editor to resolve the linkage to 
the logic module associated with this DTF. 


° Logic indicators such as one I/O area, two I/O areas, and device type. 


° Addresses of all of the areas and controls used by this device (except 
work files). 


Those parts of the DTFIS ADD-RETRVE-ADDRTR table and the DTFIS Load table that 
are significant to the Emulator as shown in Figures 51 ani 52, respectively. 
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IJHCTBLI 


O(0) 
IJHCCCB 


17(11) 
Unused DTFLMODA 


20(14) 21(15) 
DTFTYPE IWWHCOPT 


3O(1E) 
IJHCSTBY 


ae | 
IJHCCLPA 


} 


IJHCKYS2 I\JHCBLSZ 


Se 


100(64} 102(66) 
\JHCATB2 WWHCATB3 


104(68) 


: [ IJHCSADR r 


124(7C) ISHACPRC 


152(98) 154{9A) 
ISHACOTC IJHACOFC 


156(9C) 
ISHACORC Unused 


200(C8) 


IJHAARAD 


204(CC) 
IJHACUSE 


208(D0) 
IJHADKEY 


Figure 51 (Part 1 of 2). OTFIS ADD-RETRVE-ADDRTR Table 
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IJHCTBL2 


0(0) 
Unused 


IJHSIOAR 


WHCRARA 


16(10) 


ISJHCRKEY 


20(14) 
JHCRWOR 


24(18) 
IJHSDB1 


28(1C) 
IJHSLIOR 


48(30) 
IJHSCADR 


68(44) 
DTFRCTGD IJHRREGS 


72(48) 
NWHRADSV 


IJHROVCN 


IJHCTBL3 
[o10) 
Unused 
8(8) 


IJHCCCW 


128(80) 
ISHACOCR 


136(88) 
IJHACTNA 


144(90) 
WWHACTOA 


152(98) 
IJHACRID 


160(AO) 
IJHACFID 


168(A8) 


IWHACTIN 


178(B2) 


IJHACLNK 


216(D8) 218(DA) 
Unused 


IJHAISKY 


Figure 51 (Part 2 of 2). DTFIS ADD-RETRVE-ADDRTR Table 
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IJHKTABL 


[ 010) | 
; IJHKCCB 


17(11) 
Unused DTFLMODA 


J 


20(14) 


DTFTYPE IJHKOPCO 


30(1E) 
Unused IJHKCCOD 


66(42) 
Unused 


IJHKLPDR 


74(4A) 
IJHKLGLN 


76(4C) 
Key Length IJHKBKLN 


108(6C) 
IJHKPRCT 


| 152(98) | 


IJHKRDWR 


184(B8) 
IJHKADCN 


188(BC) 
Address of Data in WORKL 


192(CO) 


Address of Key in WORKL 


200(C8) 
IJHKMIXT . Unused 


Figure 52. DTFIS Load Table 
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DIFIS ADD-RETRVE-ADDRTR Table Description (Part 1) 


Offset 
*Note: 
0 (0) 

17 (11) 


20 (14) 


21(15) 


22 (16) 


30 (1E) 


43 (2B) 


60 (42) 


74 (4A) 
76 (4C) 


78 (4E) 


94 (5E) 


100 (64) 
102 (66) 


104 (68) 


124(7¢) 


Bytes 


* Hex. 


DSECT Label Dig. Field Description, Contents, Meaning 


Within IIVIS, IJH=DTF. 


16 


3 


10 


IJHCCCB 

DTFLMOCA 

DTFTYPE 
25 
26 
27 


IJHCOPT 


Pe eo ee a 


eases Vwons 


DTFFLNME 


IJHCSTAY 


lees eves 
oles cove 
eo le aces 
see l sean 
eace Teen 
ee 


ease 8 Pars br 


eos @ #8 acacter 


LJACRTR 


astee se @s 


a) Eee 2 e282 828 


IJHCCLPA 


TJHCRESZ 
IJHCRYS2Z 


IJHCBLSZ 


TJHCKYLC 


IJHCATR2 


LJHCATB3 


IJHCSADR 


IFHACPRC 


Command control block (CCB). 
Logic module address. 


File type for open/close as 
Follows; 

Add 

RETRVE 

ADDRTR 


Option byte. 
Cylinder overflow. 
Blocked records. 


DTF file name. 
Status byte. 


Uncorrectable DASD Error (except 
WLR). 

WLR error. 

EOF (sequential). 

No record found. 

Tllegal identification specified. 
Duplicate record sensed. 
Overflow area full. 

Record retrieved from overflow 
area. 


Retrieval byte. 
WORKR area Specified. 
WORKS area specified. 


Last prime data record address 
(MEBBCCHHR). 


Logical record length (RECSIZE). 
Key length (KEYLEN). 

Block size (logical record 
length times number of records 


in the block). 


Key location (KEYLOC) for blocked 
records. 


Displacement of part 2 of the 
DTFIS table from start of part 
1. 

Displacement of part 3 of the 
DIFIS table from start of part 
Ve 

Seek/search address area. 


Prime data record count. 
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Hex. 


Offset Bytes DSECT Label Diq. Field Description, Contents, Meaning 

152 (98) 2 IJHACOTC Number of independent’ overflow 
tracks. 

154 (9A) 2 IJHACOFC Number of full cylinder overflow 
areas. 

156 (9C) 2 IJHACORC Overflow record count. 

200 (C8) 4 TJHAARAD A(SIOAREAL) ~- address of IOAREAL, 


the I/O area used for adding 
records to a file. 


204 (CC) 4 IJHACUSE A{EWORKL) - address of WORKL, work 
area containing user data records 
to be added to the file. 


208 {DO) 4 IJHADKEY A{&filename.K) - address of the 
add key area. 
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DTFIS ADD-RETRVE-ADDRTR Table Description (Part 2) 


Offset 


8 (8) 


12 (C) 


16 (10) 


20{(14) 


2418) 


28(1C) 


48 (30) 


68 (44) 


70 (46) 


72 (48) 


84(54) 


Bytes 


4 


DSECT Label 


IJHSIOAR 


ITJHCRARA 


ITJHCRKEY 


TJHCRWOR 


IJHSCB1 


IJHSLIOR 


TIJHSCADR 


DTFRCTGD 


IJHRREGS 


IJHRADSV 


IJHROVCN 


Dig. Field Description, Contents, Meaning 


Address of IOAREAS, I/O area used 
for sequential retrieval. 


Address of IOAREAR, I/O area used 
for random retrieval or address of 
YOAREA2 (if specified) for 
sequential retrieval. 


Address of KEYARG, field containing 
user-supplied key used for random 
read/write operations and sequential 
retrieval initiated by key. 


Address of WORKR, work area used 
for random retrieval. 


Current sequential I/O area address. 


Load I/0 register for sequential, 
or 4-byte NOP instruction for random. 


Current sequential DASD address 
(MBBCCHHR). 


Number of records tagged for 
deletion. 


IOREG for random (or 2-byte NOP 
for sequential). 


Record pointer within I/O area 
for write (for random retrieval). 


An overflow record that is other 


than the first record in a 
chain of such records. 
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DTFIS ADD-RETRVE-ADDRTR Table Description (Part 3) 


offset 
8 (8) 
128 (80) 


136 (88) 


144 (90) 


152 (98) 


160 {A0) 


168 (A8) 


178 (B2) 


218 (DA) 


236 (EC) 


Bytes 
60 


8 


10 
10 


Hex. 


DSECT Label Dig. 


IJHCCCW 


IJHACOCR 


IJHACTNA 


IJHACTOA 


IJHACRID 


IJHACFID 


IJHACTIN 


IJHACLNK 


IJHAISRY 
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Field Description, Contents, Meanin 


I/O trap code build area. 


Cylinder overflow control record 
(COCR) . 


Current track index normal entry 
count field. 


Current track index overflow entry 
count field. 


Current prime data record count 
field. 


Current overflow record count 
field. 


Track index normal entry data field. 


Current overflow record sequence- 
link field. 


MVC 0 (&KEYLEN, 13) ,0(12) - unblocked 
MVC 0 (&KEYLEN, 13) ,&KEYLOC-1(12) - 
blocked utility MVC for key. 


Key area for add only. Number of 
bytes depends on key length, 
KEYLEN. 


DTFIS Load Table Description 


Hex. 


Offset Dig. Field Description, Contents, Meaning 


Bytes | DSECT Label 


0 (0) 

17(11) 
20(14) 
21(15) 


22 (16) 


30 (15) 


66 (42) 


74 (4A) 
76 (4c) 


78(4E) 


108 (6C) 


152 (98) 
134 (B8) 


188 {BC) 


192 (C0) 


200 (C8) 


16 


3 


32 


IJHKCCB 
DTFLMODA 
DTFTYPE 


IJHKOPCO 


ee ee @o# 


@2eee Vees 


DTFFLNME 


TJHKCCOD 


bea @eeee 
ee ee eeee 
ae Oe @#@2@e@ 


we! ee ew @ 


@eee? Nees 


ease @ Pa 
# esse Swe he 


@epgee Selon 


IJHKLPDR 


IJHKLGLN 


IJHKBKLN 


IJHKPRCT 


IJHKRDWR 


IJHKADCN 


LJ HKMIXT 
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Command control block (CCB). 
Logic module address. 
File type for OPEN/CLOSE: LOAD. 
Option byte. 

Cylinder overflow option. 
Blocked records. 

Pile name. 


Status byte. 


Uncorrectable DASD error (except WLR error). 


WLR error. 
Prime data area full. 


Cylinder index area not large enough to 


reference prime data area. 
if error detected at SETFL time. 
Master index not large enough to 
reference prime data area. 
if error detected at SETFL time. 
Duplicate record. 

Sequence error. 

No EOF record written in prime 
data area. 


Address of last prime data record 
(MBBCCHHR) . 


Logical record length. 
Key length. 


Block length {logical record 
length times number of records 
in the block). 


Prime data record counter 
(logical records). 


I/O trap code build area. 
Address of IOQAREAL. 


Address of data in WORKL. 
(FIXBLK = address of WORKL; 
FIXONB = address of WORKL + 
key length.) 


Address of key in WORKL. (FIXBLK 
= address of WORKL + KEYLOC - 1; 
FIXUNB = address of WORKL.) 


Master index indicator. x*01* 
indicates a master index is 
used; X*00* indicates no master 
index is used. 


Data Areas 


Set on only 


Set on only 
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Event Control Block 


Initialized by: IIVINT 

Modified by: IIVPCE, TIVSTSG, LIVRTE, ITIVCHK 

Pointer in: IOB 

The event control block (ECB, Figure 52) is used for communication hetween 
various components of the contrcl program, as well as between processing 


programs and the control program. It is located in COMTAB and is used as 
specified in EXCP for testing of normal or abnormal completion of I/O requests. 


Not significant to Emulator 


Figure 53. Event Control Block 


Event Control Block Description 


Bytes and Field Hex 
offset Aliqnment Name Dig. Field Description, Contents, Meaning 
0 {0) 1 ECB Flags and completion code. 

Vaari:- cease Waiting for an event to occur. The 
WAIT macro instruction has been issued 
but the channel program has not been 
completed. 

o Tete: eens The event has occurred. The channel 
program has been completed; a zero 
bit indicates it has not been 
completed. 

XXX KXXX COMPLETION CODE: 


0111 1111 7F The channel program has terminated 
without error. 

0100 0001 41 The channel program has terminated 
with a permanent error. 

0100 0010 42 The channel program has terminated 
because a direct-access extent address 
has been violated. 

0100 0100 44 The channel program has been 
intercepted because of a permanent 
error associated with a device end 
for the previous request. The 
intercepted request may be 
reissued. 

0700 1000 48 A request element for the channel 
program has been made available 
after having been purged. 

0100 1111 4F A direct-access device error 
recovery routine was unable to read 
the home address record or record 0. 
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ECB Pointer Table 


Initialized by: IIVINT 
Interrogated by: OS WAIT macro, IIVRTE 
Pointer in: EMUCONS 


The ECB pointer table (Figure 53) is a list of 4-byte addresses to the ECHs 
for devices being used for DOS emulation. The list contains an ECB address 
for each SYSE card plus an address for SYSLOG and three special ECBs. The 
special ECBs are for the Emulator prompt, WTOR, and timer. This table is 
initiated by the initialization routine. 


ECBLIST 


Address of Prompt ECB 


Address of WTOR ECB 


Address of Timer ECB 


Address of SYSLOG ECB 


16(10) 
Address of COMTAB ECB 
Entry 4 


20(14) 
Address of COMTAB ECB 
Entry 2 


24(18) 


Figure 54. ECB Pointer Table 
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File ID Block 


Initialized by: IIVIS, IIVDVS 

Modified by: IIVIS, IIVDVS 

Interrogated by: IIVIS, IIVDVS, IIVGR2, IIVSNP 

Pointer in: EMUCONS 

A file ID block (FIDBLK, Figure 54) is created for each opened file to map 


a DOS OPEN DTF to an OS OPEN DCB. The FID table is pointed to by the DSFIDBLK 
Or ISFIDBLK fields in EMUCONS. Each FIDBLK entry is formatted as follows: 


FIDBLK 


0(0) 
FIDNXT 
4(4) 
FIDPRV 
8(8) 9(9) 
FIDELAG FIDCTXTN 


FIDTFNME 


19(13) 


Unused FIDLTK 


Figure 55. File ID Block 


File ID Block Description 


Bytes and Field 


Offset Alignment Name Field Description, Contents, Meaning 
0 (0) i) FIDNXT Address of next FID block. 
4 (4) 4 FIDPRV Address of previous FID block. 
8 (38) 1 FIDFLAG X'80" indicates a system file. 
X*80* indicates a SYSREC file. 
9 (9) 3 FIDCTXTN Pointer to COMTAB extension. 
12 (C) 7 FIDTFNME Name of the DTF. 
19 (13) 1 FIDLTK DOS partition of DTF. 
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LIVCON 


Initialized by: IIVINT 

Modified by: All Emulator modules 

Pointer in: Emulator register 11 

IIVCON (Figure 56) is a CSECT assembled with IIVENT containing data constants 


common to most Emulator modules. Figure 57 is a listing of the contents of 
IIVCON. 
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Local 

Execution ISK/SSK 
List Table 
(DRILIST) 


COMTAB 


Adjust CCW 
Data Address 
List 
(RCCWLIST) 


CTEXT 
(COMTAB 
Extension) 


ECB 
Pointer 
Table 


IIVCON 


Ss FI : i UCB 
(EMUCONS DSECT) Brae ‘ : 


OS PUB 
Table ff NN 
ISAM DCB 
———_% Dedicated/staged relationship 
— — ——& Volume sharing relationship 
seeeececces B Indexed Sequential data set relationship 
—-+—-—s Volume sharing/indexed sequential 
DOS PUB d ite : i 
DOSCORE ata set relationship 


Table 


DOS PIB 


DOSCOM (DOS 
Communications 
Region) 


DOS LUB 
Table 


Figure 56. Relationship of IIVCON to Other Major Emulator Data Areas 
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DOS EMULATGR - COMMON DATA AREA 


LOC OBJECT CODE ADOR1 ADDR2 


000000 
000000 
000000 0000000000000000 
000040 0000000000000000 
000068 0000000000000000 
000080 0000000000000000 


900598 cocoo000 
o000x 00000000 
QQOOAO FFFFFFFFFFFFFFFF 
0o000A8 00000000 
ooodAc 00000000 
39000B0 900000000 
0000B4 00000000 
00008 8 00000000 
2000BC 00000000 
0000CO 00000000 
00002 4 00000000 
9000C8 00000000 
Q000cCC 0000 
QOOOCE 0000 
000000 0000 
cood2 00 
000003 00 
000004 00 

00000 5 000000 
900008 00000000 
0o0g0Cc 00000000 
9000E0 00000000 
QOOOOE4 0000 
OOO0E6 0000 
OQO00E8 00000000 


OOO0F O 

OOOOF O 

0000FO 

OOO0F 0 

OOOOFO 00 

QOOOF1 00000000000000 


OQOOFS 00000000 
QOOOFC 0000 
QOOOFE 0000 
000100 00 


000101 00 
000104 

000104 

000104 00 
oo0oolc 

900020 

000024 

000105 

000108. 

000108 

000109 

000104 

000104 

000104 00 
000105 000000 
000108 00000000 
acc1oc 

oociec ooccco00 
000110 00093000 
200114 D70907C 704404040 
00011C D70907CTD4404040 
000124 000000C0 


000128 
000128 
000128 
00012C 

00013¢ 
000134 
000138 
30013C 
000140 
000144 
900148 
QOOL4C 

00015¢ 
000154 

000158 
00o15C 
DOOLEC 

000164 


000168 00000000 
00016C ocBeca00ccodeooce 
C001B4 00012CCO 


Figure 57 (Part 1 


STMT 


SOURCE STATEMENT 


Dh we ee aE a ee a a a a ae aR ea eee a 8 a 2 ee aA ae ee 2 ae 


atx 
S+* 
6+* 


EMULATOR DATA CONSTANTS CSECT 


* 
” 


* 


Tea KK a eK ee me ee a ee a ea a a A ea a aa a aa 


9+II VCON 
10+HYPL IST 
11+ 

12+ 

13+ 

14+ 


16+ACOMTAB 
17+ADO0S PUB 
1 8 CHNI NOX 
19¢CO4TABEN 
20+ 9TGINTR 
“PECBPTRL 
>ECBPTR2 
POSTECB 
o4°ENOP TECB 
25¢ACOMT BEX 
26+ ACOMT ABX 
27+AC TE XEND 
28+RES CUU 
2H IT PLCUU 
304+LOGCUU 
31+RESOFST 
32+ I1PLOFST 
33+LOGOFST 


34+ASTCBADR 
35+TIOTADR 
36+DOSSIZE 
37+NBR2K 


38+ECBLIST 
39+ * 
40+TRNSFELO 
41+ TRNSF LOS 
42+ TRNSFLD4 
434T RNS FL D3 
44+ TRNSFLDI 
454+ TRNSFLDA 
46+% 
47+ 1 SSKTAB 
48+NBRENT 
494CT EXT CNT 
50+0P TFLGR2 
Sl+*% 

S24 

53+% 

544% 

554% 

5 ot ® 

57+ 

586 

59+ EGJ Sa 

6C ¢PARML ST 
61¢PARMOTFA 
62¢P ARMCODE 
63 *¢PARMOPEN 
64+PARMC LSE 
65+PARMEOX 
66+ 
67+PARMFDCX 
68+PARMLTK 
694+ 

70+ 
71+1S AML IST 
72+ 1 SAMCQDE 
73+1SAMDTFA 
7441S AMFDCX 
75+ 
76+DSFIDBLK 
T7+ISFIDBLK 
TBt+NXTB TR 
T940LDBTR 
80+TI MERECS 


C SECT 
DS 
pc 
DC 


B2+e%xe SAVE AREA 


84+ 
85+REGSAV 
B86tREGO 
87+REGL 
88+REG 2 
89 +REG3 
90+ REG4 
914REGS 
S2+REG6 
93+REG7 
Q44REG 8 
95+REGO 
96+ REGA 
97+REGB 
98+REGC 
99*REGO 
1GO¢REGE 
1CL¢REGF 


103¢BREG SAVE 
1C4+EMUS AVE 
10 5+ SECOND 


of 4). 


OC L152 
lOF'C! 
10F' OF 
bFroF 
6FtO! 


A(O) . 

A(OQ) . 

BX'FF' . 
AO) 
A(0) 
AO) 
ACO} 
AO) 
A(0) 
A(O) 
AiO) 
A(Q) 
H'O¢ 
HO" 
H'ot 
x'o! 
x'or 
xtar 


A(O} 
Fro? 
Fra! 
H'O? 


AiO) . 


OD. 

OCcLS . 
OCL4 . 
ocL3 . 
x'oo' . 
XL7‘00' . 


AlO) « 
H'O'. 
H'a' . 
XL1'O' . 
x'80! 
x'6or 
x20! 

x lo! 

x' pet 
x'c4 
X'02' 
x'ol' 
XLL'O' . 
OF e 
OA. 
XL1'O' . 
28 OPEN CODE 


32 CLOSE CODE 
36 END OF EXTENT CODE 


SPACE REO TO &LIGN TO 64 BYTE 
SPACE REQ FOR DRI LIST 

FORCE ALIGNMENT FOR RCCH LIST 
SPACE PEQ FOP PCCw LIST 


ADDR OF COMMINICAT IONS TA@LE 
ADDR OF DOS PLB TRL 

CHANNEL INDEY TABPLF 

COMM TABLE 

STAGED INTEPP., FOUTIME 

ECB LIST POINTER CNE 

ECB LIST POINTER THO 

KEGINNING ADDP OF PQST ECB LIST 
POST ECR LYST DELIMITING ADDP 
ADDRESS OF COMTAB EXTENSION 2-0 
PARM FOP AUTO ADD ?3UTIVE 2-" 
ENDING ADDR OF COFTAB E¥T 2-0 
DOS SYSPES CUU 

00S IPL DVC CuU 

DOS LOG DYC CuUU 

COMTAB ENT NO OF DOS SYSPES 
COMTAB EMT ND OF DIS FPL DVO 
COMTAB EN’ NO OF DOS LOG DVC 


ASYNC TCB ADORESSS 

ADDRESS OF YTLQT 

DOS SYSTEM SIZE 

NUMBER OF 2¥ INCREMENTS IN 


ADDR OF FCB LIST 


TRANSLATE WORK APEA 
UNTH & 

LNTH & 

LNTH 3 

FIRST BYTE 

LAST 7 BYTES 


ISK/SSK TABLE ADDRESS 
NUMBER OF DEVICES ALLOCATED 
NUMBER CF COMTAB EXT ENTPIES2-—9 


OPTIONS FLAG 2-0 
ISAM SUPPORT REQUESTED 2-¢ 
VOLUME SHAPING PEQUESTED 2-n 
AUTO IPL REQ'IESTED 2-4 
ABBREVIATEO PROMT REQUESTED 2-C 
SYSSNAP DO CAPO PRFSFNT 2-n 
STAGED SUPPCRT REGJFSTED 2-0 
BYPASS APENO FLAG 228 
SYSDEBUG DO CARD P°ESENT 2-8 


END OF EMULATION SWITHCH 

PARWS ~ TIVGP2/TIVIVS/TIVIS 2-0 
DTF POINTEP 2-9 
CODE 2-0 


AL3(0} . DTF ADDPESS 2-n 
OA. FIDBLK OR CTEXT POIMTER 2-0 
ALI. LOSICAL TRANSIENT KEY 2-0 
AL3 . FIDBLK OP CTEXT ADDRESS 2-9 
PARMLST , 2-0 
OF . PARMS II VI SCX 2-0 
AL1(0} . CODE 2-n 
AL3(0) . DTF ADDRESS 2-0 
AL4(09) FIDBLK ©? CTEXT ADDFESS 2-0 
ACO) . FIRST FIDPL¥ ON O/S LIST 2-0 
A(O) . FIRST FIDPBL¥ ON SSAM LIST 2-9 
CL8*PRPGM' NEXT BTR TO BE EXECUTED 2-3 


CL 8*PRPGM' NAME OF BTR 


Flot, 


FOR OCS REGISTERS 


Fo. 
CLES 


nDTTaATDANaATMDMTAHMTDTIARDT HM TWTWAsy 


Feo, 
18FtC 
F'76BLC « 


ISSUING SVC 2 2-0 


DUMMY TIMFP ECB FD? LPS 


FI ALIGNMENT 


OOS REG 
DAS REG 
ONS REG 
DOS KES 
OOS REG 
LOS REG 
DOS REG 
nos REG 
DOS REG 
09S REG 
DOS REG 
DOS REG 
OJS REG 
DOS REG 
DOS REG 
03S RFG 


ae HO DY PIN RW NY pe OD 
mn 3 


re 
un = 


REGISTER SAVE 
EMULATOP REGISTEP SAVE AREA 
GNE SECOND TIME ™WTFPVAL 


Emulator common pata Alea 


Data Areas 
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Loc 


200188 
00018C 
OCO1BE 
0001 C0 
00olc2 
9001C3 
coolcs 
ooolcc 
000100 
0001D4 


0001D8 


0001D9 


OOC1DA 
OOO1DA 
JOOLOF 
GOOLET 
OOO1EF 
JO01F5 
OOO1LF6 
OOO1F? 
OOO1LFA 


00013B 
OCO1LFC 
000202 
90022B 


00023C 
00023C 
90023C 
000240 
000243 
000244 
300248 


00024C 
00G628C 
0002 8D 
000287 
9002 BS 


000348 
000346 
00034C 


00034C 
000358 


00035C 
00035D 
000360 
00036z 
000364 


900368 
000369 
00036C 
00036D 


900370 
060378 
009379 
OOO37A 


DOS EMULATOR — COMMON DATA AREA 


OBJECT CODE ADDR1 ADDR2 


ccoc9600 

0000 

cool 

ococ 

00 

00 
oocoooocoo0000nc 
00c00000 
00000000 
OCO04E20 


1F 


01 


5CC SL 4E 440 
D1LDEC 205C 1040540 
40 07 09 Dé D4 D7 E35C 
404040464040 

ol 

00 

F7FOFO 

FFOC 


F AFBFCFDFEFF 
oo00cocoao0000ND 
FOF LF2F3F4F5F6F7 


co0cood 10 
o0000d 
00 
60000000 
00000000 


oo0ocsacon000000 
40 
sek elazexelotezelezarelarerelere) 
6B 
occcooooorcograc 


ocoacodaacoco000 
o000LaNC 


00 
oo00ccl 
0000 
2000 
occoocol 


oc 
oooodl 


E2E8E 2C 50 4404040 
02 

00 

FOO 


STMT SOURCE 


106+ SECCNDA 
1C¢7+*¢NOLOPEND 
1048+*H} 
1094NO SIO 
11C*¢PARMFLG 


111+4REGSAVE 
112+ADORWRK 
113+A0 SPUB 
114+CEAIDS 


116+IPLSW 
117+* 
118+* 
119+% 
120+* 
121 +% 
224% 
123+* 
124+* 


126+PENOSW 
127+* 
128+ 
129+* 
130+* 
131+* 
132+ 
133+* 
134+ 


136+PRPMSG99 
137¢ 

138+PR PMSG JN 
139% 

140+ PRPVSER 
1414¢PRPSW 
142+T IMEIND 
143+ BADCUU 
1444EXTMSK 


146+* 
147+HE XTAB 
148+ 
149+ 
150+ 


152+* 


154+ 

155+ SCAN TBL 
156+SCANEND 
157+ SCANCHR 
158+SCAN STP 
159+SCANBEG 
160+ SCANLNG 


162+* 


164+STPTBL 
165+ 
166+ 
167+ 
168+ 


171 +* 
172+ 
173+ 

174 +DADCB 
175+ 


177+ 


179+ 
180+ 


182+* 


184+ 
185+ 
186+ 
L87+ 
188+ 


1 90+% 


192+ 
193+ 
194+ 
195+ 


197+« 
199+ 
200+ 
201+ 
202+ 


204+ 


STATEMENT 
DC F'3e400" . ONE SECCND FOR ST IMEP 
DC H'n! , NO OF I/O PENOING 
DC H¥1" HALF WOPD CONSTANT 2F OME 
DC H'of, NO. SIO FUNCTIONS ACTIVE 
DC XL1¢90" . INITIALIZATION PEMIMOFPR FLAG 
DC 2F'O' . REGISTER SAVE 
oc ACO) « ADDRESS WOPK APEA 
oc ACO) « ADDR OF OS PUR TABLE 
DC At20G00) . ADDR OF DOS CE AIDS APEA 
oc B'0OD11111" . INITIALS ZATION (TPL) SWITCH 
BIT © - UNUSED 
BIT 1 - 'INUSED 
BIT 2 - SYSABEMD DN PRESENT 2-1 
BIT 3 - I/C FOR IPL PFADS 
BIT 4 - 1/0 TO PEA SUPFPE Vy SR 
BIT 5 — LST LOAD PS¥ 
BIT 6 - 1ST PC FOR CORF CLEARIN 
BIT 7- 1ST SW 14 (EOQYJ) 
DC K*OL’ . INTERRUPT PENDING SWITCH 
ti?’ GO - LOG PUS* 2.1 
BIT 1 - UNUSED 
BIT 2 - MODEL 135 CPL 2.1 
RIT 3 - WTO TENTERPUPT 
BIT 4 - TIME INTER? UPT 
BIT 5 -— PROMPT INTERPUPT 
PIT 6 - WTOP INTERRUPT 
BIT 7 - DRI SWITCH 
DS OCL21. EMULATOR 
DC C'*EMU ' y OPERATOP 
oc C'JOBNAMF * . PROMPT 
DC C* PROMPT#* , MSG 
oc CL6* ' VOL SER WORK AREA 
DC X'Ol't.. INITIAL PROMPT SA 
ne xoo' . TIME INDICATOR SWITCH 
DC c'700" . INVALID CHANNFL aApDe 
pc X"*FFOO' . EXTERNAL REQUPST MASK 
TRANSL ATE TABLE TO CONVEFT TI HEX * 
EQU  #*-CtAr 
oc X*FAPBFCFOFEFF! « A~ F 
oC XL41*O" . SPACE BETWEEN 
oc C'912345¢789ABCDEF! . o-9 
EMULATOR SCAN TABLE * 
DS OF . ALIGNMENT 
DS OCL16 
oc A(C) « END ADDPESS GF SCAM APEA 
pc XL3"O" . SCAN CHAP 
DC KtoOt , SCAN STOP CHARACTER 
DC A(O) . NEW SCAN STAPT PIDBESS 
DC Fror , REMAINING SCAM APEA LENGTH 
TRANSLATE TABLE TO STOP ON FLANK OK COMMA * 
DC XL64'D' . DO NOT STP 
nC chr, sTae 
DC XL42'0' . CO NOT STaP 
BC C'y’ . STOP 
BC xLb@stae DO NOT STOP 


DATA CONTROL BLICK 
GRG %-4 TJ ELIMINATE UNUSED SPACE 
DS OF'O' CPIGIN ON WORD BRUNDARY 
GRG *+4 TO ORIGIN GENERATICN 
CIRECT ACCESS DEVICE INTERFACE 


DC BL12*0* FDAD,DVTBL 
ie A(O) KEYLE ,OE VT, TRRAL 


COMMON ACCESS ME THID INTEPFACE 


DC AL1L(C) BUFNO 

DC AL 3(1} bUFCB 

oc AL2(0) BJFL 

DC BL2' O01 OCC O0RGCOrCCO' DSOKG 


boc A(Q1) 19840 


FOUNDATION EXTENSION 


DC BLINCONOFOC I" BFTEKsBFLNeHI ARCHY 
DC AL3(1L) EGDAD 
DC BLLECrOOCGCOO® RECFM 


bc AL3(XLIST) EXLST 


FOUNDATION alice 


UC CL8"*SYSEM*® DDNAME 

Oc BL1'O0000010*" OFLGS 

oc BLI*OCfOCGI0t IFLG 

pac BL2'1111eo0ecacsec1lce! MACK 


EXCP APPENDAGE LIST 
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DOS Emulator Logic 


LOC 


00037C 
300370 
000380 
900384 
G00386 
000388 
00038A 
00036C 
QQ03 8 
960048 


0t0390 
coo0391 


900394 
000394 
000394 
00039C 
0003 9E 
00034 5 
00C3 Ab 
Q003A7 
JOOZAA 
NGOSAA 
0d0ox 0 
900 3C8 
0003C9 
0003CC 
0003 K 
000304 
000307 
0003E0 


0003e1 
0003Eb 
OGC3EC 


OOO03ED 


OOC3EE 
OG03F 0 
J003F1 


G003F 2 
2003Fé 
0003F 7 
OGO3F8 
0003F9 
0003! A 
OO03FC 


0003F E 
GCC3FF 
200409 


000432 
COG403 
OGO040A 
OCO4DA 
oo64cD 
000410 


0006444 
000445 
000446 
300456 
00G424 


000458 
90045C 
900460 
0004464 
2604648 
udG4el 

I90470 
900474 

000478 


900480 
ICQ48u 
CON4Al 
000484 
30C 485 
G09456 


909468 
CCO45C 
CGI4SC 
200494 
100496 


90946 49 
900485 
CO04B9 
CO04BC 
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COS EMULATUR — COMMCN DATA AREA 


OBJECT CODE AODR1 ADDR2 
00 

o000C00 

ococgonoe 

E8C 1 

FO4C 

ESL 

FO4O 

FOS 

F O40 


B7 
000394 


codGecon 
occvoooc 
ococedso 
occooc 00 
enanooec 


0¢000940 
ececcjyoc 
€6 306091 
90CCOCOG 
ooo cc 70Cc 
Ccacov0c 


09 
Orocc 3 
00 

“0 
00cG 


£0c00000 
G36 CN00G 
C404 24045404540 


03 
OGC4BC 
40404) 


ST MT 


2Cé+ 

207+ 

zCe+ 

209+ 

210+ 

211+ 

212+ 

213+ 
Z1le+ 
215+#DACCBLEN 


21L7XL IST 
2184 


220+ JFCRAREA 
¢221+JFCBOSN 
222+ 
223+JFCPDS8 
224+ 

225+ JFC8OS1& 
226+J FCODS19 
227+ 

228+ JFCBDSJN 
£294 

230+ 
231¢JFCBIP 
232+ 

2234 JFCFCB8ID 
234+ 
235+JFCBIP 
236+ 

237+ JECBMSK1 
2384% 

239+ 

24+ JFCBINDz 
241+J FCBUFNG 
242 +% 

2434% 

244+J FCOBUF IN 
248 +% 

2464 

24 7+JFCBUFL 
268+ 

249+ JFCKE YLE 
250 +% 

251+ 

252+ JFCDSORG 
253+ 
254+ JF CRECEM 
255+JF COP TCD 
z256+JFCBBS 
257+ JFCLRECL 
258+ 

2° 9+ JFCNCP 
260+* 
26E14+JFCNTM 
2€2+% 

263+ JFCRKP 
2o4+ 
2¢h+JFCCYLOF 
266+ 
Z€7T*JFCBVSER 
268¢ JFCBEYVSARIL 
2694 JF CRYSR3 
270+ 


272+ WTOECB 
273+ABGSYSFD 
274+ABGPIB 
275+AF 2PIB 
Z76+AF1P 1B 


278+ al TVGR2 
279+ATTVOVS 
28C+ATIVISM 
2614 ARASCGNS 
282¢ IMGL BOCK 
26@2+¢O06UC0C8 
284+ STAEREGS 
285¢STAER IN 
2 Gh eAlLlVPOV 


cf Pe PCUCCH 

289+4FCKCCS wOP 
2°C +FCSCCHDF 
2OleFCACCHEG 
2924+FC BCC WX 
292+FUBCCW CT 


295+ALIVSOT 
296+ATIVVIC 
<°7+ADOS BTR 
298+A0G SP TNL 
Z9Se¢I]PL STMT 


30] +4 PRPCUURK 
30 2¢ 
Afge 
304 PROPCUUC 


SGURCE STATEMENT 


BLIfococrond® 


XL 3*OCCOOO" KEKL 


xi 4 ooconoans 
CL2*°YA* EQEA 
CL2'of PLIA 
CL2'y¥A' SIDA 
CL2'o* CENDA 
CL2°9" XENDA 
CL2°3*® AERR 
*-DADCBE .« 


x*eT' , 
ALA (JFCBAR EA) 


b> 

Oo 

~ 
ee eee 


CAs 
4L1(2). 

AL 3(PRPCUUC } 
cLa' '§ 


LENSTH OF OASO DCP 


NCB EXIT LIST FOR POJFCR MACRO) 
USAGE 


JFCS WORK AREA 
JFCS GAYA SEY NAME 


* 

* 

* 

% 

* 

* 

* 

* 

NIT USED 

JFCB INTERFACE BYTE 
NOT USED 

FCR [OEMTTFYFS 
NOT USED 


JFCB8 LABEL TYPE 


NUT USEN 


JFCA DATA MANAGMENT 
MASK BYTF 5 


NOT USED 


JFCA FLAG 
JFC®8 NUMBER OF PUFFEPS 
REQUIPED FOP THIS DATA 


SET 


JFC8 BUFFER HIERAPCHY, 
BUFFER ING TECHNISUT, 
GUFFER AL IGMP ENT 

JFCB BUFFER LFNGTR 


NOT USED 


JFCS OLRECT ACCESS KFY 


LENG 


NOT USED 


TH 


JFC8 DATA SET ORGANIZAT TOM 


NOT USED 


JFCB RECOFD FORMAT 
JFCB GPTTON CODES 
MAX BLOCF SIZE 

JFC8 LOGICAL PECOFD 


LENG 


TH 


JFCB NUMBFP CHANNEL 


PROGRAMS 


JECR NUMPER @F TRACKS 
MASTER 
JFCBR PELATIVE rev 


POS] TLON 


INDE x 


JFCH CYLENCEP OVEPF LOW 


NOT 


USED 


JFCB VOLUME SFRIAL NUMBER 


* 
* 


NOT USED 


DUMMY ECR FOP §¥SLUG 


Propel 
VJ 29790 d0" 


1 
> 


' ' 
2722797072739 


NNNNANNRN YON NDNA 
I 


t 


N 
14 
an 


yo 
oi) 


4 


( 


| 
os) 


MNNON VN N 
! 
73 


i] 
 C.3 


ADL? OF BS S¥SROR LUB 

ADDR CF EG PIB 

AODR OF ©? PIA 

AOOkK OF F1 PTB 

ADD? OF SVC 2 SUP#YSF 27tIT 2-9 
ADOR OF SHAPED VOL POUTINE 2-0 
AUDR OF ISAM ROUTINE 2-0 
PTR TO SEPVICE ATN CMTPL PLE 2-A 
PTR TO TMAGELIP NCA 7-0 
§vVAe DCR POINTER 2—n 
PTS TO SAVE APEA on 
kKETRY POINT ann 
P& INT OVERFLOW PCUTI NE 2-9 
FLE DUMMY CCW (CSTE PPINTFP) 2=9 
* OP CODE 2-A 
* PTR TO FCP IMAGE + ? eal 
* CCh FLAGS 2-4 
% 7-0 
*x CCW DATA TRNSFE? LENG e-¢ 
ADDR CF STAGED DFVICE TAALF 2-0 
ADDR OF {IvvIO am 
ADD&k OF DOS BTPANSIFNT APEA 2-0 
ADDR OF DOS ATPANS TENT END 2-fA 
LAST AUTO TPL STMT 2-n 


CUU TEAMSLATE WOPK APEFA 


LENGTH 2 
CHdék CUU 


WRK ADDP. 


CHANNEL AND UNTT 
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Loc 


0004BF 
0004t 0 
Q004C4 
00c4C& 
0004CC 
0004D0 
000404 


9004D8 
0004) 8 
0004DC 
39¢¢DC 


ON06EU 
3904 Es 
N904E 8 
O094EC 


CIO4EC 
O0U4F & 
J0C4FS 
UOOGEC 
000500 
00564 
009598 
00O50C 
00050C 
000510 
900514 
000518 


0005I1C 
390510 


90051D 
360594 


900598 
900598 
006599 


00059C 
00059C 
a00s90 
QOO59E 
OGO59F 
Q005A0 
0005A4 
OGOS AB 
000580 
900580 
000563 
ogoco4 


2005 B4 
000588 
c0056C 


O0005C4 
000K 4 
2005C8 
QOO5CC 
000509 
0005 De 
900508 
00050C 
0005 EO 
O005E 4 
OO005E8 
0005 EC 
Q005F 0 
JOCG5E4 
COCSFS 
000 5FC 
000600 


000604 


000605 
000001 
0000C 2 
000004 
000008 
00C696 
000605 
00060C 
OOOOC E 
000619 
000018 
900620 
000624 


DOS EMULATOR — COMMON DATA AREA 


OBJECT CODE ADDR1 ADDR2 STMT SOURCE STATEMENT 
oc 
ocoocoac ZOC6*ALIVMSG DC VCLIV4SG) . ADDR OF MESSAGE WPI TEP 
00000000 307 ABEBLK DC VOTITVCCWRB) . ADDR CF DE@LCCK 
ecocc nc 306+CAWSCNAD DC VOTIVAWV) . ADDR OF ILIVAWV 
00000000 309+CCWSCNAD DC VilIVCwv) . ADOR OF TIVCWV 
00Cc 00000 310+LOGIG oc VULIVLOG) .« ADDR OF TIVLOG 
cooccocc 311+AEUJCHK DC VUTIVRTEQJS) .« EQJ CHECK ROUTINE ADOR 
312+ 
313+11VCONB1 EQU * 
314+ ENTRY T[IVCONB1 
oocoooco 315+WTNRECB DC Free. WTOR ECR 
316+* 
317+1TIVCONS2 EQU » 
31e+ ENTRY LIVCONB2 
OrcGoIco 319+PRUMPECB DC Foe, PROMPT ECB 
520 4% 7 
c3ccIoce 321+ AASCHCK DC VC(TIVRTECK) . AUDR OF LIVPTECK 
CGoCcGa00 322+ABRADR DC VETIVABN) « ADDR GF ABEND ERROR RTN 
coccca0o 323+ASTGIO DC Ato} . ADOR GF IIVSTG 
00000C90 324+ AOPEN pc V(LIVOPN) . AODR GF OPEM ROUTINE 
OoCcoogc 326+ART29 DC VOTIVRTER2Z) . ADOR OF IIVRTER2 
ocsco1e" Z27+AT [MER oc V(ITIVRI ETM) « ADOR OF [IVP TFYM 
oc acccGo 328+A SVC oc V(ITIVSVC) . ADDR OF SWC ROUTIME 
ococen4se 229 4APC oc V(TIVPCE) « ADOR OF PC ROUTINE 
occo0oocca 330+ AROQUTEEP DC VCIIVATE) .« ADDR OF TIVTRE 
aagooeco 3314+AROUTE DC VOLTIVRTERI) . AADR OF TIVRTERL 
cccoonoe 332+AITIVOBE1 OC ACO) .« ALOR OF ORTAIM WORK APEA 
333+BASEREGS DS CXLl2 . COMAON BASE PEGISTEP VALUES 
oocco0000 334+ADRILST DC A(9) . ORILIST ADORESS 
coo00000 3aF+RFACTOR CC A(Q) . OQS CCPFE ADOPE SS 
concorde 336+AEMUCONS DC A(TIVCON) . EMJCONS ADRPESS 
OCCOC DCG 337+ALIVGET DC VUTIVGET) ADDRESS OF GETMAIN ROUTINE 
00 339+PRPRPLYZ DC X'00' . ZERO CLFAR CHAPAC TEP 
340+11 VWOONB3 EQu x 
341+ ENTRY IIVCONB3 . 
(olohalaleleletejsléleyerexeler 0) 342+PRPRPLY ODOC XLI1I9N'CE , REPLY APEA FOP PROMPT 
40C3 343+PRPCONTF DC c' ch. CONTINUATION CHAPACT EP 
345+0PENLIST DS OF 
60 346+ Dc AL1L(128) OPTION BYTE 
COC348 347+ DC AL3(DADCB) DCB ADLRESS 
349+QLIST DS OF 
FF 350+ DC AL1(255) LAST ENTRY INDICATION 
04 351+ oc AL 1(RNMEL EN) LENGTH 
4C 352+ oc BLI'a1cecooo' S081 
00 3536 oc AL1(0) RETURN CODE FIELD 
Q000C5 AB 354+ oc ALQNAME) QNAME AODRESS 
ococcS5B0 3556 oc ACRNAME) RNAME ADDRESS 
C9 CS E5 C5 D4 E44040 356eQNAME oc CLA*IIVEMU® . Q RESOURCE NAME 
35 7¢RNAME OS OCL4 e R RESOUPCF MAME 
404040 358+KNMC UU oc CLae OS Cuu 
40 359+RNMBIN oc Gti* * QS BIN NUMBER 
360+RNMELEN EQU L'RNAME . LENGTH OF RNAME FSELD 
ocooo00c 3624+AIITVCCW DC VOETIVCCW) TIVCCW ADDR 2-1 
co0000000 Z363+AITIVADS DC VOTIVADJ) TIVAQY ALDR 2-1 
0C0090gN9 2000000 364+CPUID oc KXLB8'O' CPU ID FIELD 2.1 
3664+CTLREGS DS OF . DOS CONTROL REGISTER FIELD 
OLB CODE O 367+CTLRO pc XL4&"EQ' . ™2, INT AMO EXT SIG MASKS 
eocacn00 348+CTLRI DC Fro’, UNUSED 
FREFFFFE 369 eCTLR2 oc Ff-1' , CHANNEL MASKS 
econ0orto 37C*CTLR3 oc Freee, UNUS ED 
OCOCoCt OF BTLOC TLRS oc Foe, UNUSED 
coco0000o ST72¢CTLRS oc Flat. UNUSED 
ececoscc 3T3*CTLR6 oc Frct . UNUS ED 
occct 30¢ 374+CTLRT DC F'ot . UNUSED 
00C00000 375+CTLR8 Dc Fro’, UNUSED 
orooceon 37T6+CTLRO oc F'o' . UNUSED 
ooococor 3774+CTLR10 BC Fen, UNUSED 
ooncenco 37@+CTLR1i oc Flot. UNUSED 
CCC06000 37SCTLR12 oc Flot, JNUS ED 
aocc¢e90Cc 36C*CTLRIG oC Fro, UNUSED 
C 4000OCO0 361+CTLRL4S oc X'C4!,XLEtOt MCH HANDLING 
00000200 382+CTLRIS pc Frs5l2' . MCEL PTR (MCH) 
oc 284+5370SW oc Xfor, SWITCH FOP 370 
3858 EQU x'208 . SHARED COSPES VOLUMF FLG 
C8 SB6*DKEL EASE DC X*O08* DOS RELEASE SUPPORT 2-1 
387+REL2Z5 EQu X'C1" 25 21 
388+REL25€ EQU K'O2' 25E 2-1 
389+REL26 EQU X'O4' 26 2-d 
39C+REL27 Eq X*OB" 27 2-1 
COCC 391+ oc 2X*00! SPARE FLAGS 2-] 
o0cec300 392+DOSRFTB DC A(Q) ADD OF DOS RF TABLE 2-1 
ae 393*EMULBLAD DC Hint. LABEL CYL ADDP -CC- 
00co a 
ococoocenoorccoc 3944TDELTA oc D'N*® FIME DIFF BTWN OS AND ONS 2-1 
4coccd00g0doGa0N0 395+ WKAREA Dc D'C! WORK AREA 2-1 
cocecoc#o 396+STCKADDR DC A(0) ADURESS OF SVC 34 STCK INST 2-1 
BBPEBBEBBRBBBHBB 397+EMUPATCH DC 1320xK "6B? ABGUT 5 PEPCEBT 2-1 


Figure 57 (Part 4 of 4). 


442 


DOS Emulator Logic 


2-0 


1atfettre 


Nnmnm pn I Tp feo Se aS 
ee en ne ee 


t 


Emulator Common Data area 


IIVRCN 


Initialized by: IIVRAS 

Modified/interrogated by: IVRAS, IIVSNP, IIVRCP, IIVSCI, IIVPCI, TFIVAc! 
Pointer inz IIVCON 

IIVRCN (Figure 58) is a CSECT assembled with module IIVRAS containing data. 


constants common to the serivce aids modules. Figure 59 is a listing of the 
contents of IIVRCN. 
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IIVRAS 


IIVRASVC 
(IIVRAS 
Supervisor 
Call Entry 
Point) 


IIVRASYN 
(IIVRAS 


IIVRASPC 


(IIVRAS 
User SVC 


Asynchron- 
ous Entry 
Point) 


Program 
Check Entry Exit Routine 


Point) 


IIVPCE 


User 
Asynchron- 
ous Exit 
Routine 


IIVSVC 


User Local 
Execution 
Exit Routine 


IIVRCN 
(RASCONS 


(Entry Point — 
IIVRTER2) _ DSECT) 


IIVRTE 


User Program 
Check Exit 
Routine 


CLIAN 


IIWVRTE 


——s Points to 
| | P 
IVACI IWRC — — —p Loads and deletes 


| 
| 
IIVSNP | IIVSCI IIVPCI 
| 
| 


Relationship of IIVRCN to Other Service Aids Modules, Other 


Figure 58. 
Emulator Modules, IIVCON, and User Routines 
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LOC 
¢C0000 
cc0000 


300000 
Cc0008 


JCOCO8 
CCOOOC 
CCOCOE 
900010 
7C0012 


J00014 


300008 


CCOCIC 
CCQ00A 


900030 


000031 
CC0032 


cc0033 


CC0034 


JC0036 


390008 


CCOC3E 
3€0040 
D0CQDA 
CCOCE4 


CcOcs55 
CcOC56 


JCCC57 


Figure 59 (Part 1 of 3). 


RAS CCNSTANTS 


OBJECT CUDE 


08098C &29C9ID9EIF 


ccoocccco 
0000 
c000 
0000 
0024 


coococcoocco0000 


acacooco0g000co0 


co 


C033 


coccoccaooccco000 


cccc 
cacccccoccca0000 


cc 


ADDR1 ADDR2 


STM T SOURCE 


3+1IVRCN 
4+RASCCNS 
5+RASOPCDS 
6+RAS CPFLEN 


8+ RASTRCTB 
9+RASTRCMX 
10+RASTRCNX 
11+RASTRCNG 
12+TRCLEN 


14+RASTRCDS 
15+ 
16+* 
17+* 
18+* 
19+* 
20+ 
21+ 
22t* 
23+ TRCDLEN 


25+RASTRCUU 
26+RASTRLEN 


28+RASTRSW1 
294% 
30+RASTRSW2 
31+RASTRSW3 
32+ 
334% 
34+* 
35+% 
36+ 
37+RASTRSW4 
38+ 


404+RASSNENC 


42+RASAFCDS 
43+ 

444% 

45+ 

46+% 

47+ 

48+% 

494% 

50+* 
51+SNPLEN 


5 3+ RASNFCUU 
54+SNPCUULN 


56+RASNFSW1 
5 1+ 
58+RASNP SW2 
5 9+RASNFSW3 
6C+* 
6]14+* 
62+% 
63+% 
64+*% 
65+ RASNPSW4 
65+% 


STATEMENT 

CS ECT 

E QU IIVRCN 

DC XL 8" 08098082 9C SD9E9F® 
EQU *-RASOPCDS . 

DC A(Q) . 

DC H*Q? 

CC H*Q! 

DC H'ao' . 

DC H' 36! 

DC XL8'O" ,. 

EQU X*osccooggocood0oo!® 
EQU X*Q0090000CC000000! 
EQU X*0000800000000000! 
EQU x'coccoo0c 82cccoaqdoco! 
EQU X'000000009C000000' 
EQU X*§ C0000000009D0000 * 
EQU X*CCCCOOQQOCO0SE 00! 
EQU X*O0Q0000000C000009F ! 
EQU *-RASTRCOS . 

DC 5FYO' . 

EQU (*¥-RASTRCUUI/2 . 

CC X'OO' . 

EQU XfOl' . 

DC x'Oo' . 

DC X*OO" . 

EQU X*l10" . 

EQU Xfol® . 

EQU X*O2" . 

EQU X'O4' . 

EQU X*O8' . 

DC x'oo' . 

EQU X'Ol' . 

DC HtSi® 

DC XLB'O' . 

EQU X©oscoccogecocoooo' . 
EQU XtQ009000000000000' . 
EQU x'coo0oscooo000o0og0odo0' . 
EQ.U X*COCOO0082000C00CO' . 
EQU XtQQ00000009CO00GOO00' , 
EQU X'cCo0d0cooocgSsSDOONO' . 
EQU X*OCOO00000COO9ENO' . 
EQU X*Q00000000000009F! 
EQL *-RASNPCDS . 

DC BEEQU 6 

EQU (*-RASNPCUU)/2 . 

CC X*OO" . 

EQU X'ol’ . 

DC X*'OO" , 

DC Xoo" . 

EQU X'l1o" , 

EQU X*fOl® . 

EQU X'O2" . 

EQU X'O4" . 

EQU X'O8* . 

DC x*oo' . 

EQU xfol'. 


VALID OP CODES 
LENGTH GF TABLE 


ADDRESS OF TRACE TABLE 
NUMBER CF ACTIVE ENTRIES 
NEXT AVAILABLE ENTRY 

TRACE TABLE ENTRIES 

LENGTH OF EACH TRACE ENTRY 


SPECIFIED TRACE OP CODES 
SSK TRACE 

ISK TRACE 

SSM TRACE 

LPSW TRACE 

S10 TRACE 

TIO TRACE 

HiO TRACE 

TCH TRACE 

LENGTH OF TABLE 


TRACE CUU TABLE 
SIZE OF TABLE 


TRACE SWITCH 1 

TRACE "IQ © PARM SPECIFIED 
TRACE SWITCH 2 

TRACE SWITCH 3 

TRACE *SVC* PARM SPECIFIED 
TRACE "EXT* PARM SPECIFIED 
TRACE *INT® PARM SPECIFIED 
TRAC’. "ATTN PARM SPECIFIED 
TRACE "TIMER FARM SPECIFIED 
TRACE SWITCH 

TRACE *"ALL* PARM SPECIFIED 


SNAP TABLE ENTRIES 


SPECIFIED SNAP OCP CODES 
SSK SNAP 

ISK SNAP 

SSM SNAP 

LPSW SNAP 

STO SNAP 

TIO SNAP 

HIO SNAP 

TCH SNAP 

LENGTH OF TABLE 


SNAP CUU TABLE 
SIZE OF CUU TABLE 


SNAP SWITCH 1 

SNAP "I0 * PARM SPECIFIED 
SNAP SWITCH 2 

SNAP SWITCH 3 

SNAP "SVC* PARM SPECIFIED 
SNAP "EXT® PARM SPECIFIED 
SNAP "INT" PARM SPECIFIED 
SNAP "ATTN®' PARM SPECIFIED 
SNAP "TIMER! PARM SPECIFIED 
SNAP SWITCH 4 SNAP ALL 
SNAP *ALL* PARM SPECIFIED 
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Loc 


0G0058 
JOO000C 
CCOOO0A 
eeLoze}ele 
CCCOOE 


90015C 
900160 
000168 
000172 
00017C 


00017D 


COOLTE 


CCO1LTF 


000180 
GCO1 84 
cco1es 


30018C 
c¢c0190 
000194 


000198 
GCO19C 


QCO1A0 
0C01 A4 


CCO1A8 
OOO1AC 
cC01B86 
0001B4 
000188 
GCOI1BC 
9001C0 
9001C8 
¢co1pbc 
0001D8 


CCOLEC 
OOO1E2 
OcO1ES 
ccCO1eE5 
C00201 
cco2ol 
000209 
000209 
CCO2Z0A 
Q0020A 
J0020C 


RAS CCASTANTS 


OBJECT CODE ADDR1 ADDR2 


cocooccocccco000 


coccoccoocco0000 


ccoaccco 
000000C000000000 
ccecccccooccocoao 
cooccccoocco00000 
00 


00 


00 


00 


ccccooco 
o0coo00co 
ccCCcCccco 


000000C0 
00000000 
oocaccco 


00000000 
ccccccco 


coocccco 
00c00000 


coccccco 
00000000 
ccoaocoo 
coccocco 
00000000 
ccccccco 
COCSE5C9C 1E24040 
C9CSE5L9C1 E24040 
C9CSE5C9C 1E24040 
C9C9E5C09C 1E24040 


c023 
E2D5C 10 740C 4E4D4 


00 


0015 
ETETETE74OE7ETET 


Figure 59 (Part 2 of 3). 
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STMT 


SOURCE 


68+CMPBLK 
69+CMPLENL 
TO+CMFLEN 
71i+C MPBLK2 
72+CMPL EN2 


T44+RASPSWSV 
T5+PSWSAVE 
76+ PSWMSK2 
TT+PSWSW 


79+ STGRG SW 
80+* 
81+* 
8 2+% 
83+% 


€5+RASFLGI1 
86+* 
87+* 
88+* 


SO+RASPCSW 


9 2+ARASPCE 
932+RASPC 
94+AIIVPCI 


S6+ARASSVC 
9T+RASSVC 
9B+ALTIVSCI 


1O0+ARASRTE 
1LO1+RASCTHER 


103+ RASART2C 
105+ARASNP 


1C7+SVCCKN 
1C8+VIIVCON 
1094+S VCEX AD 
110#¢PCEXITAD 
1114#LEXADR 
112+ASY KEXAD 
113+ SVCEXRTN 
1144+PCEXRTN 
115+LEXRTN 
L1L6+ASYNE XRN 


118+CUUSAVE 
119+ TYPSAVE 
120+L EXMSG 
1214+ EXMSG 
122+ 
123+MQONM 
124+ 


125+ 
126+LOPTMSGL 
127+OPTMSG1 


STATEMENT 

DC XL120°0O* COMP INPUT AREA 

EQU 12. LENGTH OF CMPBLK1 

EQU (*-CMPBLK)/CMPLEN: TA3LE SIZE 

DC XL140'°O* . COMP INPUT SAVE AREA 

EQU 14 » LENGTH OF CMPBLK2 

DC D'O* . PSW SAVE AREA 

DC XL10°O*" . 

OC XL10"°O" . MASK FOR PSW OPTION 

DC x*00" . PSwW SWITCH 

DC X*O00" » STORAGE SWITCH 

EQU x*OO* . STORAGE=(EMBLKS, DOS} 

EQU X*O1l" . STORAGE=(EMU; DOS} 

EQU x*d2" . STORAGE=( ALL; CCS) 

EQU X*10" . STORAGE=(¢ ,NODCS) 

DC X*Of . FLAG BYTE 

EQU x*Ql' TRACE NOT COMFLETE 

EQU X*02' PROGRAM CHECK INTERRUPT 

EQU X*Q4! CAUSE OF SNAP IS EQUAL COMP 
DC XO!" , PROGRAM CHECK SWITCH 

DC A(O) .» REPLACEMENT ACDR FOR DP IPC 
DC A(Q} . VCLIVPCE) -— INIT BY YIVRCP 
DC A(O) . ACILIVPCT) 

DC AtO) .» REPLACEMENT ACLCCR FOR ORISVC 
DC A(O) . V(IIVSVC) -— ENIT BY FIVRCP 
DC A(O} . AI TiIVSC!) 

DC AO) . REPLACEMENT ACDR FOR ORIOTHEF 
DC AtO) . VC IIVRTE} -— INIT BY LEVRCP 
DC A(O) . VOTIVRTER2) ~ INIT BY TIVPRCP 
DC A(C) . V(LTIVSNP) 

DC A(O) . POINTER TO BEGINNING OF CHAIN 
DC A(O) . INITIALIZED BY TIVRAS 

DC A(O) SVC EXIT ROUTINE ADDR 

DC A(O) PC EXIT ROUTINE ADCR 

DC A( 0) LEX EXIT RTN ACDRESS 

DC 400) ASYN EXIT ROUTINE ADDR 

DC CL8*TIVRAS * SVC EXIT ROUTINE NAME 

DC CLE"*TIVRAS ¢* PC EXIT ROUTINE NAME 

DC CL8"IIVRAS * LEX EXIT RTN NAME 

DC CL8*IIVRAS * ASYN EXIT ROUTINE NAME 

DC H'O' . CHANNEL AND UNIT SAVE APEA 
DC xfor.. TYPE OF INTERRUPT 

DC AL 2(L'EXMSG-1) LENGTH MINLS CNE 

CC C*'SNAP DUMP INVOKED BY MODULE XXXXXXXX* MSG 

ORG *¥-L'LEXRTN RESET [C 

OS XL8 LOAD MODULE NAME 

ORG EX*SG+L'EXMSG RESET IC 

CNOP 244 ALLIGN ON HALF WORD BOUNDRY 

DC AL2(L'OPTMSG1-1) . LENGTH MINUS ONE 

DC C*'XXXX XXX SNAP X CF X* . MSG 
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LOC 


cco020C 
0cd20C 
000210 
0co211 
g0021C 
Ocdo2z1C 
0CC222 
000222 
000224 
€C0238 
J0023C 
0C0240 
000240 
000240 
000264 
000278 
oco2z7Cc 
C€CC283 
000292 
Cc02s7 
00029C 
QO02AB 
CC02B0 
0002B9 
c002B9 
OCO2BA 
@002BC 
CCO2BE 
0c02c0 
Q002C4 
cco2c8 
cc003Cc7 
0003C8 
C€co000 
ccoo00 
000004 


RAS CCASTANTS 


OBJECT CODE ADDR1 ADDR2 


0013 
DTE2ZE67EETETETET 
océlccco 
007D0000 
4040404040404040 


Fl 06E261F3F6F040 


E3C9C04C540 
ETETETEVEVE? 


C4C1E3C540 
ETETETE7ET 


07C1C7C540 
EVE7E7E? 


00 

oool 

0000 

ccao 

ccc.cccco 
00000000 
000000C0000000.00 
00 
0000000000000000 


ccoode 
0c0080 
ccccc7 
ccoccs 
000074 


Figure 59 (Part 3 of 3). 


STMT SOURCE STATEMENT 
128+ ORG OPTMSG1 . RESET IC 
129+CPTICN OS XL4 . CAUSE 
130+ DS X FILLER 
131+0FTCUU DS XL3 CUU 
132+ ORG OPTNSGL+L'OPTMSG1-6 . POINT TO SNAP NO 
133+SNPNO DS XL6 . SNAP X OF X 
134+ ORG OPTMSGI14+L*OPTMSG1 . RESET IC 
1354+LPSWSVE DC AL2(L'*PSWSVE-ONE) . LENGTH OF MSG 
136+PSWSVE DC C §PSW=XXXXXXXXXXXXXXXX! MSG 
137+BHDR1 DC AL2(L'HDR1+8),AL2(0) BOW 
138+LHDR1 DC AL2(L*HDR1+4) -AL2(0} ROW 
139+HDR1 DC CL121" * HEADER RECORD 
140+ ORG  HCRI1 RESET IC 
14 1+ DC C*10S/360 DOS EMULATOR SERVICE AIDS * ID 
142+ DS CL20 FILLER 
14 3+ DC CL5' TIME" ID 
144+HDRTIME DC C*XXXXXX* TIME 
145+ DS CL15 FILLER 
146+ DC CL5"*DATE® ID 
1474#HDRCATE OC C'XXXXX"* DATE 
148+ DS CL15 FILLER 
149+ DC CL5*PAGE® ID 
150+HCRPAGE DC C*XXXX" PAGE 
LE1+ ORG HERL+L*HDRL RESET IC 
152+LINECNT DC H'1¢ LINE COUNT FOR I!VRCP 
1£3+PAGECNT OC H'oF PAGE COUNT FOR IIVPCP 
154+RASCIAG DC F°'O0' ADDR OF FIRST DIAG BLOCK 2-1 
155+#RASCCW DC F'o' SAVE IIVCCW ADDRESS 2-1 
156*#RASTRSVC DC XL255"00* . SVC TRACE TABLE 
157+P TCHAREA DC 1coD'o' . MAINTENENCE PATCH AREA 
158+CIAGBLK DSECT CIAGNOSTIC BLOCK FOR CCW 2-1 
15S+DIAGNXT DS F ACDR OF NXT BLOCK 2-1 
160+DIAGCUU DS CL2 DOS CUU 2-1 
161+CIAGFLAG DS CL1 FLAG BYTE 2-1 
162#DIAGREL EQU  xX*80" ON IF RELOC+SAVE 2-1 
163+ DS CL1 UNUSED 2-1 
164+CIAGBUF DS CL108 BUFFER(SAVE FOR DOS CH.PGM) 2-1 
165+#DIAGLNG EQU %*=DIAGBLK LENGTH OF DIAG BLK 2-1 
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Input/Output Block 


Initialized by: IIVOPN 

Modified by: IIVPCE, IIVINT, IGGO019S1, OS, IIVCHK 

Interrogated by: IIVPCE, TIVCHK 

Located in: COMTAB {(X'38! offset) 

The input/output block (TOB) is the primary means of communication hetween 

a requestor of an I/O operation and the I/O supervisor. All of the information 
passed between the requestor and the I/0 supervisor is either contained in 


the IOB or pointed to by the I[0B. 


Although the I/0 supervisor uses IOBs, it neither creates them nor disposes 
of them; IOBs belong to the requestor of an I/O operation. 


Only those parts of the I0B that are significant to the Emulator are shown 
in Figure 60 helow. 


0(0) 2(2) 

|OBFLAGT Unused tee ee 
4(4) 5(5) 

Uimused |OBECBPT 
8(8) 

Unused 


16(10) 
Unused 


20{14) 


IOBSENS1 


lIOBCSW 


lIOBSTART 


Uipeead IOBDCBPT 


IOBSEEKM 


IOBSEEK 


Figure 60. Input/Output Block Fields Used by the Emulator 
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Input/Output Block Description 


offset 


0 (0) 


2 (2) 


3 (3) 


5 (5) 


9 (9) 


17 (11) 


21(15) 


32 (20) 


33(21) 


Bytes and Field 
Alignment Name 


1 


IOBFLAG1 


00.. @eea@e 
0 tas eev#ses 
10.6 @a@eeoes 


TOBSENSO 


IOBSENS1 


IOBECBPT 


TOBCSW 


IOBSTART 


LOBDCBPT 


ITOBSEEKM 


IOBSEERK 


Field Description, Contents, Meaning 
Flag byte 1. 


No chaining. 

Command chaining. 

Data chaining. 

Both command and data chaining. 


Not a related I/O request. 


Note: Bits 0, 1, and 6 are set as 
required by EXCP. 


Sense byte 1 is tested or passed 
to DOS (see IIVCHK for details). 


Sense byte 2 is tested or passed 
to DOS {see IIVCHK for details). 


Address of the ECB to be posted 
upon completion of the I/0 
event. 


Low order seven bytes of the last 
csw for this request are passed 
to DOS when I/O interruptions are 
Simulated. 


Address of the first CCW in the 


channel program to be executed. 


Address of the DCB needed for 
this request. 


M = the number of the DEB extents 
for the data set to he read or 
written. 


BBCCHHR = the seek address of 
a direct-access volume: 


Disk 
Bytes 1-2 zeros 
Bytes 3-4 Cylinder number 
Bytes 5-6 Read/write head number 
Bytes 7 Record number 
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ISAM Block (ISBLR) 


Initialized by: IIVIS 
Modified by: IIVIs 
Interrogated by: IIVIS, IIVGR2 {FIDBLK only), and IIVPCE (FIDBLK only) 


Pointer in: ISREGSVA field (following FIDBLK field, which is pointed to by 
EMUCONS) 


The ISAM block (ISLBK, Figure 61) is built by the Emulator when a DTF is opened 
and is used at I/O macro time to map the DOS DTF to the OS DCB. 


ISBLK 


O(0) 
ISREGSAV 
72(48) 
FIDBLK 
92(5C) 
ISECB 


ISREGSVA 


ISLIST 


ISWKNARA 


ISFLAGS 


ISDECB 


384 (180) 


ISDTFLMA 


388 (184) 
ISDCB1 


623(26F) 


Figure 61. ISAM Block (ISBLR) 
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ISAM Block (ISBLK) Descrirtion 


Bytes and 
Offset Alignment 
0 (0) 72 
72 (48) 32 
92 (5C) 4 
96 (60) 4 
100 (64) 4 
104 (68) 8 
104 (68) 
105 (69) 
108 (6C) 
112 (70) 4 
116 (74) 4 
116 (74) 
117¢75) 1 


Name 
Field 


ISREGSAV 
FIDBLK 


ISECB 


ISTCB 


TSREGSVA 


ISLTST 


Byte 1 
ISCODE 


Bytes 2-4 
ISDTFA 


BYTES 5-8 
ISCOMTAB 


ISWKNARA 


ISFLASS 


Byte 1 
TAFLAG1 
AS ees. tevcvatis 
elee cece 
cole cece 
A ee ee ae 


a2aeee# 2 eee) 


Byte 2 
TAFLAG2 
rere e2e#e#s@ 
se nes oe eo @ 


Vals eg8ses 
tess ee 8 @ 


ee 
=@#@oe @e @ : Pea 
ess 0 ere | 


*#eo 6 pe ee 


Hex. 


Dig. Field Description, Contents, Meaning 


Register save area. 
File identification block. 


Event control block used for 
communication between the Emulator 
main task and subtask. 


Address of task control block for 
subtask associated with ISBLK. 


Address of ISREGSAV. 


Parameter list used to communicate 
an T/O request from the main task 
to a subtask. 


I/9 request code. 
WRITE NEW KEY. 
WAITF. 

GET. 

PUT. 

WRITE KEY. 

ES"TL. 

READ KEY. 


Address of DTFIS table. 


Address of the COMTAB entry to which 
this I/O request is related. 


Address of the WRITE type KN work 
area. 


Indicators, 


I/O request status indicator. 
GET successful. 

READ KEY issued. 

WRITE KEY issued. 

WRITE NEWREY issued. 

READ successful. 

Not used. 


OPEN/SETL status indicator. 
Open for QISAM. 

Open for QISAM load. 

Open for QISAM search by record or 
generic key. 

Open for QISAM search by device 
address. 

Set for all SETLs. 

Open for BISAM. 

OCpen for BISAM in DCB 2. 

Open for BISAM add in DCB 1. 
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Bytes and Name Hex. 


Offset Alignment Field Dig. Field Description, Contents, Meaning 
waren 1k Ws Open for BISAM RETRVE in CCB 1. 
wave Vet) Open for BISAM RETRVE in DCB 2. 
awa AAA Open for RISAM ACDRTR in DCB 1. 
Seow 109 Open for RISAM ADDRTR in DCB 2. 
Byte 3 
TAFLAG3 Subtask/main task control indicator. 
118 (76) 1477079979 Subtask in contrcel. 
90c0 0000 Main task in control. 
Byte 4 
119 (77) TAFLAGA Not used. 
120(78) 236 TSCCB CISAM load mode: DCB when creating 
file. 


QISAM scan mode: DCB when 
sequentially retrieving file. 
BISAM mode: CCB only when adding 
records to file. 

356(164) 28 SPECB BISAM-mode data event control block 
used when accessing file for random 
retrieval or add mode. 


394 (180) 4 ISDTPLMA Save area for address of DTF (define 
the file) logic module. 


388(184) 236 ISDCB1 BISAM-mode data control block when 


randomly retrieving and/or adding 
records to file. 


ISK/SSK Table 


Initialized by: IIVINT 

Modified by: IIVPcE 

Pointer in: EMUCONS 

The insert storage key/set storage key (ISK/SSK) table contains one 1-byte 
entry for each 2K block of DOS dynamic storage. It is initialized to zeros 


by the initialization routine. The appropriate protection key for each block 
is stored in its related hyte entry. 


Job File Control Block 


Initialized by: oS 

Modified by: IIVINT, TIVCEN 

Interrogated hy: IIVINT 

Obtained by: Issuing RDJFCB macro instruction 


The job file control block (JFCB) is an internal representation of a DD 
statement. 


Only those parts of a JFCB that are significant to the Emulator are described 
in Figure 62. 
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2 


0(0) 


JFCBDSNM 


JECBTSDM Unused 


66(42) 
Unused JFCBLTYP Unused 


102(66) 

Unused JFECBLKSI 
118(76) 

Einused JFCBVOLS 


Pigure 62. Job File Control Block Fields Used by the Emulator 


Job File Control Block Description 


Bytes and Field 


Offset Alignment Name Field Description, Contents, Meaning 
0 (0) ay JFCBDSNM This field is initialized to 44 bytes 


of X*04' to indicate the VTOC data 
set name. The tenth character is 
examined to determine SYSIN and 
SYSOUT files. 


52 (34) 1 JFCBTSOM A X*20' in this byte is assumed to 
mean a SYSIN or SYSOUT file. 


66 (42) ae | JFCBLTYP This byte is set to X'10' to assure 
BLP option. 


102(66) ..2 JFCBLKSI If the blocksize for staged I/O is 
not specified ina DD statement, this 
field holds a default blocksize (89 
bytes for punch, 141 for print). 


118(76) ..6 JFCBVOLS The OPEN routines move volume identifi- 


cation (VOLID) into this field for 
mount requests. 
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Local Execution List 


Initialized by: IIVINT 


Modified by: ILIVINT, IIVPCE, ILVLOG, LIVSTG, IIVPRP, execute local instruction, 
TIVRAS, IIVSNP, IIVSCI, IIVACI, ITIVPCI, ITIVRCP 


Interrogated by: IIvcCcW, IIVRTE, IIVAWV, IIVCWV, IIVPCE, IIVGR2, IIVRAS, 
IIVSNP, IIVSCI, IIVACI, IIVPCI, TIVRCP 


Pointer in: EMUCONS and Emulator register 9 


The local execution list (Figure 63) contains information that enables the 
Emulator to acquire control after an interruption and subsequently return 
control to DOS. See the Appendix for details concerning DOS emulation. 


Programming Use Interruption Code 


Local Instruction Address 


Register 14 


Register 15 


17(11) 
Reserved True Origin Address 


21(15) 


Reserved Local Limit Address 


25(19) 


Reserved True Operation Pointer 


29(1D) 
Reserved SVC Interruption Address 


33(21) 


Reserved : Program Interruption Address 


37(25) 


Reserved Asynchronous Interruption Address 


Figure 63. Local Execution List Fields Used by the Emulator 
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Local Execution List Description 


offset 


0 (0) 


2 (2) 


4 (4) 


4 (4) 


4 (4) 


5 (5) 


8 (8) 


12 {C) 


17(11) 


21(15) 


Bytes and Field 
Alignment Name 


2 


ook *#*e 8 @ 


xXKXX 


Field Description, Contents, Meaning 


The Emulator cannot change the condition of the 
first two bytes. 


Interruption code. Identifies the cause or source 
Of an interruption. When an interruption occurs 
while in local execution mode, the interruption 
code is placed in the local execution list. 


Instruction length code {ILC). When an 
interruption occurs while in local execution mode, 
the current value of the ILC is placed in this 
area of the local execution list. 


Condition code (CC). When an interruption occurs 
while in local execution mode, the current value 
of the condition code is placed in this area of 
the local execution list. 


Program mask (PM). When an interruption occurs 
while in local execution mode, the current value 
of the program mask is placed in this area of 
the local execution list. 


Instruction address. When an interruption occurs 
while in local execution mode, the address of 

the next sequential instruction is placed in this 
area of the local execution list. 


Register 14. When an interruption occurs while 

in local execution mode, the contents of register 
14 are placed into this area of the local execution 
list. 


Register 15. When an interruption occurs while 

in local execution mode, the contents of register 
15 are placed into this area of the local execution 
list. 


True origin address. This area holds the address 
of the Emulator program corresponding to address 

0 in the emulated environment. It must be on 

a 4096-byte boundary (the three low-order 
hexadecimal digits equal 000). The origin address 
is added to the local limit address to determine 
that the maximum local address falls within the 
storage limits of the system. 


Local limit address. This area holds the maximum 
address usable by the emulated DOS programs. 

The address value must be on a 4096-byte boundary 
~1 (the three low-order hexadecimal digits equal 
FFF). All local instruction and operand addresses 
are 
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Bytes and Field 


Offset Alignment Name Field Description, Contents, Meaning 
checked by the DOS Compatibility Feature (in J 


Models 135 and 145) against the local limit address 
to determine whether they fall within the adjusted 
DOS storage area. Any address found to be greater 
than the local limit address causes an addressing 
exception. The DOS Compatibility Feature in Model 
155 does not do this checking. However, all 
addresses contained in the local execution list 
are checked for boundary alignment. 


25{(19) 3 True operation pointer. When an interruption 
condition is raised while in local execution mode, 
the true address of the last executed instruction 
{except for the object of an execute instruction, 
in which case it is the true address of the execute 
instruction itself) 1s stored in this area of 
the local execution list. 


29{1D) 3 SVC interruption address. When an SVC interruption 
cccurs, the SVC interruption address from the 
local execution List replaces the instruction 
address of the current PSW. This area holds the 
address of the Emulator SVC interruption routine.! 


33 (21) 3 Program interruption address. When a program 
interruption occurs, the program interruption 
address from the local execution list replaces 
the instruction address of the current PSW. This 
area holds the address of the Emulator program 
interruption routine.2 


37 (25) 3 Asynchronous interruption address. When an iy 
external or I/O interruption occurs, the 
asynchronous interruption address from the local 
execution list replaces the instruction address 
of the current PSW.3 A machine check interruption 
causes unpredictable results. 


iThe Emulator SVC interruption routine (IIVSVC) determines if device or data 
set sharing is involved. If not, TIVSVC moves the first two words from the 
local execution list to the DOS SVC old PSW Location 32(20). It then moves 
the DOS SVC new PSW into the first two words of the local execution list. 

The DOS SVC interruption routine then handles the interruption in the usual 
manner. If device or data set sharing is involved, the SVC is checked to see 
if it is a 2, 4, or 11. If not, IIVSVC swaps PSWs in the manner described 
above. If the interruption is an SVC 2, 4, or 11, module IIVGR2 further 
analyzes it and then returns to LIVSVC with an indication of whether SVCs 
should be swapped cr control passed to the next instruction following the SVc. 
For further information concerning DOS emulation interruption handling 
procedures, see the explanation of the DOS Compatibility Feature in the 
Appendix. 


2The Emulator program interruption routine (TIVPCE) moves the first two words 
from the local execution list to the DOS program old PSW location 40 (28). 

It then moves the DOS program new PSW into the first two words of the local 
execution list. The DOS program interruption routine then handles the 
interruption in the usual manner. 


3The interruption is then handled in the normal OS manner by storing the old 
PSW and loading the appropriate new PSW. 
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Logical Unit Block 


c Initialized by: DOS 
Interrogated by: IIVOPN, IIVRTE, IIVGR2 


Pointer in: DOS COMREG 


The logical unit block (LUB) is a 2-byte entry in the LUB table for each logical 
unit specified. The first byte is used as a PUB pointer; the second byte is 
not significant to the Emulator. 


LUB Table 


The LUB table (Figure 64) contains a 2-byte entry for each logical unit 
specified. The first entry must be for SYSRDR. 


00000000- Points to first PUB 
00000001 - Points to second PUB 
0000001 0- Points to third PUB 


Number in First 
Class List Class List LUB Table for Any = Null Pointer. the LUB is 
(NICL) _UB Table (FICL) Partition Unassigned 


BG SYSRDR 
System 
SYSIPT 


SYSPCH 


YS SYSLST : : 


: SYSLNK we rmat of Any LUB PUB Pointer | JIB Pointer 
. SYSRES : 
grammer 


LUBs SYSSLB 


SYSRLB 

SYSUSE 
grammer ee Not Significant to Emulator 
LUBs SYS000 

SYS001 

SYS002 

SYS003 


SYS004 


mal 


When in single program initiation mode (foreground 1 or 2): must be unit record device and can be referenced by 
the program. 


When in single program initiation mode (foreground 1 or 2): can be referenced by the program. 
Cannot be referenced by foreground programs. 


Note: The location of the LUB table is found in bytes 76 and 77 (X‘4C’-‘4D‘) of the communications region. 
Label DOSLUB identifies the first byte of the table. 


C Figure 64. Logical Unit Block Table 
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Open Table 


Initialized by: DOS 


Interrogated hy: IIVIS, IIVGR2, IIVDVS 


Pointer in: B-transient area in DOS register 15 at SVC 2 time 


The open table {Figure 65), located in the B-transient area, is a common section 
for all OPEN/CLOSE phases and is initialized by phase 1 of the OPEN or CLOSE 


monitor. Only the fields listed in the figure are significant to the Emulator. 
Address Field 
Dec. Hex Bytes Name Field Description, Contents, Meaning 
888 378 104 CSCDLB DLBL image (sequential only). 
992 3E0 8 LIMTBCKT Limit (lower and upper CCHH). 
1000 358 8 CCB CCB used by DOS open. 
1018 3FC 7 SEKADR Seek bucket (CCHHR). 
1033 409 uy SRCHKEY Search argument. 
1184 4A0 1 F4INDIC VTOC DSCB indicator. 
FHINCORE X01" = on if VTOC DSCB read into core. 
1185 WAY 1 MSGINDIC Monitor ID for message routine. 
MSGOUT X*F4' = message ID for 
sequential output. 
MSGIN X'*F3"' = message ID for sequential 
input. 
MSGWF X'F9" = message ID for sequential 
work file. 
1187 4A3 1 OPTBFLGS OPEN indicators. 
OPTBLNK X*40* = SYSLNK open. 
OPTBSYFL X‘'02' = SYSTEM file. 
OPTBFLPT X*"01* = file protection. 
1192 4A8 4 LABADDR Address of DLBL. 
Figure 65. Open Table Fields Used by the Emulator 


Physical Unit Block 


Initialized by: Dos 


Modified/Interrogated by: IIVPCE, IIVCHK 


Interrogated by: IIVOPN, IIVPRP, IIVGR2 


Pointer in: DOS COMREG 


The DOS PUB and OS PUB tables provide a one-to-one correspondence between a 
DOS device and its associated OS device. 
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DOS PUB Table 


The physical unit block (PUB) is an 8-byte entry in the DOS PIB table (Figure 
66) for each physical unit specified. Byte 0 contains the channel number; 
byte 1, the device unit number; byte 3, the TEB pointer or the error count; 
byte 4, the device type code; and byte 6, the channel scheduler flags. These 
are the only bytes significant to the Emulator. 


OS PUB Table 


The OS PUB table (Figure 66) contains a 1-byte entry for each DOS PUB. If 
there is no OS equivalent for a DOS PUB entry, the OS PUB entry will be X‘'FF*. 


DOS PUB 
Table Channel 
Channel 0 Unit 
AOSPUB ADOSPUB PUBS 


TEB Pointer or Error Count 


Device Type 
i Channel 1 


Channel Scheduler Flags 


Channel 7 


PUBS E 


PUB table 
delimiter 


Byte QO - Channel number (hex 0-7, FF=NULL). 
Byte 1 - 1/O device unit number. 
Byte 3 - If device is a magnetic tape unit* and TEBS are specified, this byte isa TEB pointer (hex 1, 2, 3...). 
If device is a magnetic tape unit* but TEBS are not specified, this byte is an error counter. 
If device is not a magnetic tape unit*, this byte is an error counter. 
The error count must indicate to the DOS error routines when it has reached the maximum number of retries. 
*2400 series or 2495 Tape Cartridge Reader. 
Byte 4 - Device type codes are mapped with corresponding OS device type codes during Emulator initialization. 
Byte6 - A 1inbit 7 indicates a 7-track tape unit. 


Note: Only the fields noted above in any PUB are significant to the Emulator. Bytes 64 and 65 of the DOS communications 
region contain the address of the PUB table entry. 


Figure 66. OS PUB and DOS PUB Tables 
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Post ECB List 


Initialized by: IIVINT 

Modified/interrogated by: IIVPCE, IIVRTE, IIVCHK 

Pointer in: EMUCONS 

The post ECB list contains one 2-byte entry for each entry in the communications 
table (COMTAB). The first byte is an index into CCMTAB. The second byte is 

the condition code from the ECB when it was last posted. 

An entry is made for each ECB posted by OS except for the three special ECBs 
(prompt, WTOR, and timer) and the SYSLOG ECB. The entries represent I/0 
interruptions to be simulated to DOS on a first-in, first-out queue. 


Four pointers are used to process this table: 


* PECBPTR1 This pointer to an entry in the table indicates that it just 
finished I/O interruption processing. 


e PECBPTR2 This pointer indicates the next entry available in the table. 
e POSTECB This pointer indicates the first entry in the table. 
° ENDPTECB This pointer indicates the last entry +2 bytes to prepare for 


wraparound to the first entry in the table after the last entry 
is processed. 


Program Information Block 

Initialized by: bos 

Interrogated by: TIVOPN 

Pointer in: DOS COMREG 

The first part of a program information block (PIB) contains program status 
information about DOS. Only byte 0 is significant to the Emulator (Figure 


67). 


The second part contains the address of the communications region (Figure 68), 
which is significant to the Emulator. 


Both parts of the PIB must be in the following order: all bound, background, 
foreground 2, and foreground 1. 


Problem Program P|IB* 


1 ; : : + 
Bytes 90-91 of the communications region contain the address of the first part of the PIB table (see Figure 77—-DOS Communications 
Region Fields used by the Emulator). 


Byte O (PIBFLG) must indicate the following: 
Background PIB must have X‘82' when waiting for a CCB to be posted. 
F2 and F1 PIBs must have X’80’ if they exist and are inactive. 


Figure 67. First Part of Program Information Block Table 
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C 


Problem Program PIB : 


‘Bytes 124-125 of the communications region contain the address of the second part of the PIB table (see Figure 77—DOS Communi- 


cations Region Fields used by the Emulator). 


* Background, F2 and F1 PIBs must contain a pointer to their associated communications region (COMREG) in bytes 0-1. 


Figure 68. Second Part of Program Information Block Table 


Program Status Word 
Initialized by: DOS 


Modified by: IIVOPN, IIVPCE, ITIVLOG, 


Interrogated by: IIVRTE, ITIVACL, 


Located in: Local execution 


list 


LIVPCI, 


IIVPRP, LTIVSTG, ITVGR2 


TIVSCI, TIVSNP 


The program status word (PSW, Figure 69) is a two-way communication Link between 
a CPU and a program. All PSWs occupy permanently assigned main-storage 


locations. The PSWs are: 


DOS SVC old PSW 

DOS SVC new PSW 

DOS program old PSW 

DOS program new PSW 

DOS I/O old PSW 

DOS I/0 new PSW 

DOS external old PSW 

DOS external new PSW 

DOS machine check old PSW 
DOS machine check new PSW 


1(1) 


System Mask 


Symbolic 
Name 


DCSSVOLD 
DOS SVNEW 
DOSPGOLD 
DOS FPGNEW 
DCSTOOLD 
DOS IONEW 
DCSKTOLD 
DOSATNEW 
COSMCOLD 
DOSMCNEW 


Protection Key 


Location 


32(20) 
96 (60) 
40 (28) 
104 (68) 
56 (38) 
120 (79) 
24 (18) 
88 (58) 
48 (30) 
112 (70) 


Interruption Code 


0 78 


1112 


31 


Instruction Address 


Bits 


Figure 69. Program Status Word 
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Program Status Word Description 


Bytes and Field 


Offset Alignment Name Field Description, Contents, Meaning 
0 (0) 1 System mask. This field is used to determine 


if DOS is enabling interruptions. Each bit 
represents a potential interruption source. 

A system mask bit of one allows the 
corresponding source to cause an interruption. 
A mask bit of 0 prevents interruptions from 
cccurring; they remain pending. 


Vabe~ Sree Channel 0. 
ee eee Channel 1. 
bigal ae caaretate Channel 2. 
atelonkr ee Channel 3. 
Sere Viewed Channel 4, 
Saeis tai Vee Channel 5. 
ee ee ee Channel 6. 
ee eee External interruptions (timer 


interrurtion key, and external signals 
Of the direct control feature). 


1 (1) 4 bits XXKX ese Protection key. This key is matched with 
a storage key whenever data is stored in 
Or fetched from a location that is protected. 


1(1) 4 bits ooue, RREX AMWP bits. The WP bits are tested to 
determine wait or problem state. The four 
bits indicate: 


sive Saas Not significant to the Emulator. 

a | q205 ao Va Machine check interruptions can occur. 

: Geog te Vax Machine check interruptions will remain 

rending. 
pare. sale The CPU is in the wait state. 
ecec see The CPU is in the running state. 
wie. £6054 ' The CPU is in the problem state. 
wens 0200 The CPU is in the supervisor state. 
2 (2) wae Interruption code. Identifies the cause 


Or source Of an interruption. When simulating 
an I/O interruption, the Emulator stores 

the address of the channel end and device 

that caused the interruption here. 4 (4) 

Re oe seas Instructicn length 
code (ILC). For program or supervisor call 
interruptions, contains the length, in 
halfwords, of the last interpreted 
instruction. For I/O, external, and machine 
check interruptions, the ILC is unpredictable. 
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Bytes and Field 


offset Alignment Name Field Description, Contents, Meaning 
4 (4) a0 KX Shoes Condition code (CC). Reflects the results 


of the execution of an instruction. Modified 
by the Emulator. 


48) enw ae (KEKE Program maSk (PM). Each bit represents a 
potential interruption source. <A program 
mask bit of 1 allows the source to cause 
an interruption. A mask bit of 0 prevents 
the interruption frem occurring. 


came laws Fixed-point overflow. 
waee, wo: deve Decimal overflow. 
ee ae eas Exponent underflow. 
ciae awed Significance. 
5 (5) 23 Instruction address. The leftmost byte of 


the instruction to be executed. 


Staged I/O Constants Block 


Initialized by: IIVOPN 

Modified/Interrogated by: TIIVSTG, IITVAWV, ITIVcwV, ITIVPOV 

Located in: COMTAB at X'38' offset 

The staged I/0 constants block (STGCON, Figure 70) which resides in the COMTAB 


IOB area for staged devices, contains data unique to the particular device 
being staged. The Emulator both creates and uses the STGCON. 
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0(0) 1(1) 2(2) 3(3) 
STGFLG STGWK1 STGSENO STGSEN1 
4(4) 6(6) 
STGLNCNT STGLNPTR 


8{8) 


Unused 


16(10) 
STGCHFLG 


18(12) 
STGMAX 


STGOPCD 


STGCTP or STGBUF 


28(1C) 
STGCCW 
32(20) 34(22) 
STGDLM 
Unused 


36(24) 
STGCUU 


Figure 70. Staged I/O Constants Block (STGCON) 


STGFLG2 


Staged I/O Constants Block Description 


Bytes and Field 


offset Alignment Name Field Description, Contents, Meaning 
0 (0) 1 STGFLG Flag byte 1. 
: ee Staged reader. 
aT. slaeis Staged printer. 
eole seas Staged punch. 
gale A! Steen SYNAD (I/O error). 
See. lawe Read, no feed, command encountered. 
sissies: « Vase EODAD (qenerate /& next SIO). 
Sates. Jeo la EOD (anit exception next SIO). 
ae ee First CCW in a chain. 
1 (1) = STGWK1 Work byte. 
22) aol STGSENO Sense information for last I/0 
operaticn. 
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Bytes and Field 


Offset Alignment Name Field Description, Contents, Meaning 


3 (3) ee | STGSENT1 Sense infcrmation for current I/0 
Operation. 

44) 2 STGLNCNT Number of lines per page {required 
by module IIVPoV). 

6 (6) sez STGLNPTR Index into in-storage carriage tape, 

8 (8) 1 Unused Reserved for future use. 

9 (9) Be STGCSW Simulated channel status word. 

16 (10) 2 STGCHFLG In-storage carriage tape channel 
flags. 

18 (12) ae STGMAX Maximum number of bytes that can he 
transmitted to or from this device. 

20 (14) 4 STGOPCD Opcode translate table address. 

24(18) 4 STGCTP Printer: in-storage carriage tape 
address, or 

STGBUF Reader: address of the last OS 

input buffer, if a staged reader 

28 (1C) 4 SIGCCW DOS CCW address. 

32 (20) 2 STGDLM DOS JCL delimiter. 

34 (22) ood Unused Reserved for future use. 

36 (24) 3 STGCOU DOS cun in EBCDIC. 

39{27) waded STGFLG2 Flag byte 2. 


Reserved for future use. 

3211 line position check. 

Punch stacker RP3 has been previously 
selected. 

Punch stacker P2 has been previously 
selected. 

Punch stacker P1 has been previously 
selected. 


KRKXXX 2easn 


2s 38: = #8 Negev 


2 e223. 8 ae ee 
eas @ ea-\¢ 


esea2sg8 aera | 


Tape Error Block 

tTnitialized by: pos 

Modified by: IIVCHK 

Pointer in: DOS COMREG 

The tape error block (TEB, Figure 71) is generated for each 2400 Series Magnetic 


Tape Or 2495 Tape Cartridge Reader unit and is the index for T/O error retry 
suppression hy the Emulator. 


A TEB is referenced from byte 3 of a magnetic tape mit PUB. 
Only byte 0 of the 6-byte THB is significant to the Emulator. This hyte keeps 


track of the error recovery retry count; the count is set to 254 when the 
Emulator wants to suppress DOS retries. 
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TEB Table Not significant to Emulator 


TEBTAB 


SK 


O- Error recovery retry count 


One TEB is generated for each 2400 Series magnetic tape or 2495 Tape Cartridge Reader unit if the FOPT macro contains the 
TEB = n parameter. Job control resets each TEB at normal or abnormal end-of-job. An unused TEB contains 
HE X’F FOOOOO00000'. A TEB is referenced from byte 3 of a magnetic tape unit PUB. 


Bytes 70 and 71 (X’46'-'47') of the communications region contain the address of the TEB table entry. 
Label TEBTAB identifies the first byte of the table. 


Figure 71. Tape Error Block 


Tape Error by Volume 
Initialized by: Dos 


Modified by: IIVCHK 
Pointer in: DOS BG communication region extension 


The tape error by volume {(TEBV) is a DOS table composed of one status block 
and (n) error blocks and pointed to by the TEBVTAB field in the DOS BG COMREG 
extension. The TEBLEN and TSBLEN fields are used in conjunction with the TEBV 
index field in the PUB (byte 3) to locate the TEBV retry counter. This counter 
is set to a higher count to force DOS I/0 retries. For further information 
concerning the TEBV, see the DOS System Programmer's Guide. 


Only those parts of the TEEV that are significant to the Emulator are described 
in Figure 72. 

Decimal 

displacement | Label Description 


TEBLEN Length of TEBV error block (for 
each error block generated) 


TSBLEN Length of TEBV status block (4, 
6, or 22 bytes) 


Retry counter 


Figure 72. Tape Error by Volume Fields Used by the Emulator 
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Task Input/Output Table 


Initialized by: os 

Interrogated bys: IIVINT 

Pointer in: EMUCONS 

The task input/output table (TIOT) maps JFCBs to UCBs. 

Only those parts of the TIOT (Figure 73) that are significant to the Emulator 


are described below. 


DD Entry 


TIOELNGH Unused 


TIOEDDNM 


TIOEFSRT 


Figure 73. TaSk Input/Output Table Fields Used by the Emulator 


Task Input/Output Table Description 


Bytes and Field 
offset Aliqnment Name Field Description, Contents, Meaning 


PD entry: A DD entry includes a device 
entry. Before allocation, there may be 
several device entries in each DD entry. 


0 ¢0) 1 TIOELNGH This field contains the length of each DD 
entry and is used to scan the TIOT during 
initialization. 

4 (4) 8 TIOEDDNM This field is scanned to determine DOS units. 


Device entry: During the execution of a 
problem program, contains 1 device entry 
for each allocated device. 

11) -3 TIOEFSRT Devices other than 2321: address of the UCB. 


2321 Data Cell Drive: address of the descrip- 
tion in the UCB of the cell in the bin. 
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Unit Control Block 


Initialized by: 0S, IGG019S1 

Interrogated by: IIVINT, IGG019S1, IGG019SA 

Pointer in: DEB 

There is a unit control block (UCB) for each device attached to the system. 
It describes the characteristics of the device to the I/O supervisor and is 


used by the job scheduler during allocation of the device. 


Only those parts of the UCB (Figure 74) that are significant to the Emulator 
are described below. 


Common Segment 


0(0) 1(1) 
Unused UCBFL5 Unused 


Common Segment 


16(10) 
UCBTYP 


Data Cell Drive 
56 (38) 
DCELBBNR Unused 


Figure 74. Unit Control Block Fields Used by the Emulator 


Unit Control Block Description 


Bytes and Field 


Offset Alignment Name Field Description, Contents, Meaning 
1(1) ~1 UCBFL5 UCBEXTSN-UCB+24 (UCBNBRSN) contains 
ereneter “Haters the number of Eytes of sense information 


and UCB+25 (UCBSNADR) contains the address 
of the sense information. 


16 (10) 4 UCBTYP Bytes 3 and 4 of this field are used to 
identify the device class and unit type, 
respectively, for the purpose of cross- 
referencing them with DOS device types during 
initialization. 


The SIO appendage modifies the DER, based 
on the device type. The abnormal end 
appendage determines whether OS or DOS is 
to handle I/O errors, based on the device 
type. 


56 (38) 2 DCELPBNR Bin number for a data cell drive. 
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Volume Label 


Initialized by: IIVDVS (simulates volume label used by DOS) 

Interrogated by: DOS, TIVVIO, IIVDVS 

Located in: first record (tape) or cylinder 0, track 0, record 3 (DASD) 

A volume label is 80 characters long and identifies the volume and its owner. 
On direct-access volumes, it is record number 3, which follows the two IPL 
records. It is recorded as an 84-byte physical record consisting of a 4-byte 


key area containing VOL1 and an 80-byte data area. Figure 75 shows the fields 
in the volume label that are significant to the Emulator. 


VOLLABI 


VOLSERNO 


10(A) 


Reserved 


DASD: VOLVTOC 


Figure 75. Volume Label Fields Used by the Emulator 


Bytes and Field 


Offset Alignment Name Field Description, Contents, Meaning 

0 (0) 3 VOLLABI Label identifier - VOL. 

3 {3) re | VOLNO Volume label sequence number - 1. 

4 (4) 6 VOLSERNO Volume serial number that uniquely identifies 


the volume. This field may contain from 
one to six alphabetic or numeric characters, 
left justified with blanks in the remainder 
of the field. 


17 (B) eaeD VOLVTOC Direct-access storage: The CCHHR address 
of the VTOC DSCB on this volume. 
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DIAGNOSTIC AIDS 


Hints for Debugging 

Emulator Dependencies on DOS, OS, and Hardware 
» Dependence on DOS 

° Dependence on OS 

® Dependence on Hardware 

Service Aids 


Emulator General Register Assignments 


Emulator Messaqge-to-Module Relationships 
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HINTS FOR DEBUGGING 


When error conditions such as program checks, channel program checks, or channel J 
protection checks occur, they may be due to violations of Emulator restrictions 

by DOS programs. One example is the modification of a CCW by a DOS problem 

program between its issuance of an EXCP and the WAIT. The following information 

may be of assistance in debugging such conditions. 


The conditions listed below, found in DOS and/or Emulator storage, may indicate 
violations: 


° Channel program CcW addresses have been adjusted only part way through 
a group of CCWs by module IIVCCW (adjust CCW data address routine). 


° Channel programs contain data addresses that appear to be improperly 
adjusted (from true to local addresses or vice versa). 


® Channel programs or CCWs are properly adjusted, but are not currently in 
use (that is, no active COMTAB entries point to the channel program in 
question). 


° Input channel programs have the SLI bit off, and the sum of its data address 
and the count field exceeds the address of the DOS area. 


e Program check occurs in module ITvccW during execution of the adjust CCW 
string instruction. 


° DOS CSW status indicates a program check. The CSW program check bit is 
set by module IIVABN when module IIVCCW could not adjust the channel program 
Or the BEBLK was full. 


Emulator tables and fields that may be useful in locating channel programs 
and determining I/O status are: ; 


* COMTAB - contains one entry per device with all I/0-related information, 
including a pointer to the last channel program used for the device (DCB, 
IOB pointers, FCB, etc.). 


e COMTAB ~- while examining T/O request and/or the IOB, keep the following 
in mind: 


= Stand-alone seeks are simulated by use of the CSW field contained 
in the IOB. All other fields in the IOB relate to the last EXCP 
issued. The same applies to stand-alone sense commands where the 
IOB sense field is ncnzero at the time the sense is issued, except 
that the simulated CSW is stored in the EMUCCW1 field of COMTAB. 


= The I0B is also used for issuing NOP commands within the Emulator 
and, therefore, the information contained in the IOB is not always 
associated with a DOS request. 


° NOSTO - STO counter in CSECT JIVCON. The value in this counter represents 
the number of DOS I/O operations initiated by OS EXCPs whose associated 
I/O interruptions have not been queued in the post ECB list. 


* NOTOPEND - number of queued I/0 interruptions to be simulated to DOS by 
IIVPCECK, entry point to the check I/O routine (ITVCHK). The value in 
this counter represents the number of entries in the post ECB list. This 
counter is also located in IIVCON. 


Note: DOS programs violating storage protection requirements can also produce 
unpredictable results. 
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EMULATOR DEPENDENCIES ON DOS, OS, AND HARDWARE 


Dependence on DOS 


DOS Low Storage and Communication Regions 


The following area in DOS low storage and communication region is referred 
to by the Emulator. This listing briefly describes what the area contains 
that is relevant to the Emulator. 


DOS Area Address (Hex) Description of Use 
Low storage 0-7F Bytes 0-127 are as assumed to exist as 
{Figure 76) in stand-alone DOS. 

14 AS in stand-alone DOS, contains the 


pointer to the background (BG) 
communications region. 


DOS BG 2C Contains the label area length. 
communication 
region (COMREG) 34 X'08* in this byte must indicate 
(Figure 77) timer support. 
35 X*40' in this byte must indicate 
a multiprocessing system. 
38 X'0B8' in this byte must indicate 
that the job is to be canceled. 
uO Contains the address of the PUB 
{physical unit block). 
46 Contains the address of the TEB (tape 
error block). 
48 Contains the address of FICL. 
LA Contains the address of NICL. 
AC Contains the LUB. 
58 Contains the LIOCS communication 
bytes. 
5A Must contain a 2-byte address of 


the first part of the PIB. 


6E Contains the logical transient 
key. 
7c Must contain a 2-byte address of 


the second part of the PIB table. 


88 Contains a pointer to the 
communication region extension; 
if the latter does not exist, 
must contain zeros. 
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DOS Area Address (Hex) Description of Use 


DOS Ft and F2 38 X'08" in this byte must indicarce 
COMREGs that the job is to be canceled. 
(Figure 77} 
DOS BG COMREG 0 Must contain an address pointer 
Extension to the CE table or zeros. 
(Figure 78) 

12 Contains the PIK. 

20 Contains the address of the TEBV 

table. 


eps 


76(4C) 


0(0) —_ARA9a$a a. Reet to Zeros after IPL 


56(38) 64(40) 72(48) 


20(14) 24(18) 32(20) 40(28) 48(30) 


Comm Region External SVC Program Machine Check 1/O CSW CAW BG Job 
Address 


@. 
@ 


0(50) 


System Timer 


84(54) 


System Timer 
of Day 


88(58) 


External 
New PSW 


96(60) 


SVC New 
PSW 


104(68) 112(70) 120(78) 


Program Check Machine Check 1/0 
New PSW New PSW New PSW 


Figure 76. DOS Low Storage 


COMREG! 
44(2C) 52(34) 53(35) 54 (36) 


Label Area Length Machine Configuration System Configuration 
Byte Byte 


56(38) 57 (39) 64(40) 66(42) 70(46) 
Job Control Byte Address of PUB Address of TEB 


72(48) 74(4A) 76(4C) 78(4F) 88(58) 
LIOCS 
Address of FICL Address of NICL Address of LUB Communication 
Bytes 
90(5A) 110(6E) 112(70) 124(7C) 
Address of ; 
First Part of PIB Logical Address of Second 
Table Transient Key Part of PIB Table 


126(7E) 136 (88) 
Pointer to 
Communication 
Region Extension 


‘The address of the communications region is in fixed location X‘'14’ - ‘17’ (see Figure 76 - DOS Low Storage). 


Figure 77. DOS Communications Region Fields Used by the Emulator 
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18(12) 20(14) 32 (20) 


CE Table Address Program Interrupt TEBV Table 
Key (PIK) Address 63(3F) 


Figure 78. DOS Background Communications Region Extension Fields 
Used by the Erulator 


DOS Control Blocks 


The DOS control blocks in Figure 79 are referred to by the Emulator. This 
directory briefly describes how each block is used. The field names listed 
are those contained in the DOS supervisor assembly listings. The blocks are 
further described in the "Data Areas" section. 
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Control 


Block Field Displacement 
Name Name Decimal Hex 
cc3 CCBCOM 1 2 2 

9 9 
LUB 0 0 
PIB PIBFLG 0 0 
PIB PIBCOMRA 0 0 
PUB PUBCHANN 0 0 
PUB PUBDEVND 1 1 
PUB PUBERR 3 3 
PUB PUBDEVTY 4 4 
PUB PUBCSFLG 6 6 
TEB TEBERRCT 0 8) 
TEBV TEBLEN 0 0 
TEBV TSBLEN 7 1 
TEBV TEBV 24 18 
Figure 79. DOS Control Blocks 
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Bytes 


Descrirtion of Use 


Bit 1 is normally set on at channel 
end to signify that the I/0 
operation was completed. 


Bytes 9-11 must contain the address 
of the CCW associated with this 
CCE. 


The first 2-byte entry in each 
LUB table must be for SYSRDR. 
Byte 0 is used as a PUB pointer. 


The F1 and F2 program areas must 
have X'80' when they are inactive. 
The BG program area must have X'82°* 
when it is waiting for a CCB to 

be posted. 


Bytes 0 and 1 of the second part 

of PIB must contain the address 

of the corresponding communications 
region. 


Must contain the channel address. 
Must contain the device address. 


Must contain either the error retry 
count or the TEB index for I/0 
error retry suppression by the 
Emulator. 


Contains device-type codes that 
are mapped with corresponding OS 
device type codes during Emulator 
initialization. 


A 1in bit 7 indicates a 7-track 
tape unit. 


Error retry count is set to 25a 
when the Emulator wants to suppress 
DOS retries. 


Length of TEBV error block (for 
each error block generated). 


Length of TEBV status block (4, 
6, Or 22 bytes). 


Retry counter. 


J 


DOS IPL and Initialization 


The Emulator also depends on DOS for the following information: 


e IPL records - Simulation of DOS IPL by the Emulator is based on the IPL 
records description in the IBM Svstem/360 Disk Operating System, IPL and 
Job Control Programs. 


e $$ASTPL2 - This phase is loaded during DOS initialization. The Fmulator 
scans for the DOS clear main-storage routine in this phase. The operation 
code of a move character (MVC) instruction in the clear main-storage routine 
is then set to 0. (See *DOS IPL! in "Method of Operation" section.) 


e First LPSW - The Emulator requires that the first LPSW instruction following 
an SVC 4 must signal that DOS is ready to begin processing IPL input. 


e First Svc 14 - The first SVC 14 received must signal the end of DOS TPL 
and initialization. 


DOS SIO 

When the Emulator intercepts an SIO not originating from a DOS CE serviceability 
routine, registers 1 and 3 must contain the addresses of the associated CCB 

and PUB entry, respectively. 


CE SIO 
When the Emulator intercepts an SIO originating from a DOS CE serviceability 
routine, it is assumed by the Emulator to be executed from a higher storage 


location than the normal (DOS STO) request. The contents of registers 1 and 
3 are not significant, as after a DOS SIO. 


DOS Time of Day 


The address of the DOS SVC table must be contained in the 1ast nonzero halfword 
preceding the DOS communications table. 


B-Transient Phases, Sequence, and Table 


6 S$BOPEN or £$BOPEN2 - One of these DOS chases must set registers 2, 6, 
and 7 with the DTF pointer, the XTENT card image pointer, and the COMREG 
pointer, respectively. 


e B-transient sequence - The sequence of calls between the 8-transient phases, 
for OPEN, CLOSE, and FOV must be followed or results will be unpredictable. 


° Open table - The format and fields significant to the Emulator for this 
table are found in "Data Areas." 
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DOS Programming Considerations 


e DLBL and EXTENT statements or, in the alternative, VOL, DLAB, and XTENT 
statements, supply the information needed to build SYSRES CDASD labels. 


e ISAM I/O macro calls - All calls for the logic (I/0 access) phases must 
culminate with BAL 14,XXX(15) where register 15 is loaded from the DTFIS 
table (displacement X'10') with the address of a logic phase, register 
1 contains the address of the DTFIS table, and Xxx is the displacement 
into the standard ISMOD kranch table for the desired I/O operation. 
Register 14 contains the return address for the calling routine. 


e DTFIS - Defined within the problem program. The format and fields 
Significant to the Emulator are found in "Data Areas", 


Dependence on OS 


The following OS facilities are used by the Emulator: 


Macros 


OS macros used ty the Emulator are shown in Figure 80. 
Note: 


e Each module summary in the Program Organization section lists the macros 
issued by that particular module. 


The macros in the following list can be better understood in the context of 
overall Emlator operation, which is presented in "Method of Operation." For 
a basic description of the operands of these macros and their operation, refer 
to Supervisor Services and Macro Instructions and Data Management Macro 
Instructions for O€ or OS/VS. 
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OS Macro 


ATTACH 


CHAP 


CHECK 


CLOSE 


DCB 


DCBD 


DELETE 


DEQ 


DETACH 


ENQ 


Figure 80 {Part 1 of 5). 


Emulator module 


Iivits 


Tivis 


IIvis 


TIVSNP 
IITVRCP 


IIVPRP 


IIVDVS 


IIviIs 


IIVRCP 
TIVABN, 
IIVOPN, 
IIvis 
IIVSNP, 
IIVDVS, 
IIVOPN, 
ILVSTG 
TIVRAS 
IIVRCP 
TIVMSG 
IIVOPN 
IIVIN2, 


IIVIS 


TIVIN2 


issuing macro 


TIVCON, 
IIVRCP, 


IIVRCP, 
IiIvis 
TIVIN2, 


ITVABN 


Use of Macro 


Issued to attach (create) a subtask to 
process ISAM I/O macros at open. The 
subtask is assigned a higher dispatch- 
ing priority than the Emulator task. 


Issued to reduce the dispatching 
priority of the Emulator task to 
expedite subtask processing. 


Issued to test completion of direct 
retrieval ISAM macro instructions, 
such as READ K, WRITE K, and WRITE KN. 


Issued to test completion of WRITE. 
Issued to test completion of WRITE. 
Issued after a MOUNT reply (to a 
prompt) has been entered. After 
emulation is finished, OS closes the 
Emulator-related data sets. 

Issued after a DOS CLOSE macro has 
been trapped by IIVGR2 for a 
sequential DASD or direct-access 
data set residing on a shared volume. 


Issued to close OS indexed sequential 
data sets. 


Issued to close the SYSDEBUG data set. 
Issued to create the DCB format 
according to file organization and 
access methods. 


Issued to generate a DSECT that shows 
the structure of a DCB. 


Issued to delete I[IVSNP and IIVRCP. 

Issued to delete IIVACI, IIVPCI, and IIVSCI. 
Issued to delete IIVMSG1, IIVMG2, and IIVMG3. 
Issued to delete forms-control image. 

Issued to release control of an OS device. 


Issued to remove (eliminate) a subtask 
at close. 


Issued to request exclusive control 
of an OS volume for the issuing 
Emulator job. This prevents two 
Emulator jobs from using the same 
OS volume concurrently. 


QOS Macros Used by the Emulator 
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O5 Macro 


EOV 


ESETL 


EXCP 


EXTRACT 


GET 


GETMAIN/Z 
FREEMAIN 


IDENTIFY 


IMGLIB 


IOHALT 


Figure 80 (Part 2 of 5). 
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Emulator module 
issuing macro 


ITIVOVS 


TIVIS 


ITIVPCE, 


TIVIN2 


LIVOPN 


LIVINT 


LIVSTG 


Iivis 


TIVRCP 


IIVGET 


LTIVSTG 


ITVRCP 


IITvis 


LTIVOPN 


LIVPCE 


Use of Macro 


Issued when additional space is 
required by means of a secondary 


allocation parameter on a 
sequential DASD output data set. 


Issued toc terminate sequential 
retrieval. 


Issued on behalf of DOS I/O requests 
that are not directed to the console 
and not to be staged. 


Issued to read the DOS bootstrap 
channel program. 


Issued to ensure protection of OS 
password data sets. 


‘Issued to obtain the address of the 


TIOT from the TCB. 


Issued on behalf of DOS input requests 
when staging has been indicated. The 
input operation is always to an OS 
CASD. 


Issued to sequentially retrieve records 
from an OS indexed sequential data set. 


Issued to read service aids control 
Statements. 


Issued (GETMAIN) for the size of DOS 
plus 4K bytes. After DOS is aligned on 
a 4K boundary, IIVGET issues a 

FREEMAIN to release the extra 4K bytes; 
subsequent GETMAINs obtain space in the 
Same area(s) for Emulator tables and for 
the DOS residence file's DCB and IOB. 


GETMAIN issued for main storage for forms-control 
image. FREEMAIN issued to free old forms—control 
image if old one exists. 


GETMAIN issued to obtain main storage for the 
trace table, Svc blocks, and DIAG blocks. 
FREEMAIN issued to release main storage obtained 
from the GETMAIN. 


Issued to add an entry point to IIVIS 
for use by the subtask. 


Issued to open the SYS1.IMAGELIB data set. 
Issued to terminate I/O on a tele- 


processing device when DOS performs an 
HIO operation. 


OS Macros Used by the Emulator 


C 


C 


OS Macro 


LOAD 


OBTAIN 


OPEN 


OPEN TYPE=J 


POST 


Figure 80 


Emulator module 
issuing macro 


IIVCEN, IIVPUB 


ITIVRCP 


TIVIN2 
IIVPRP 
ITIVPUB 
ITIVRAS 


IIVMSG 


IIVABN 


TIVDVS 


TIVDVS 


TIvis 


TIVIN2 


IIVRCP 


LIVABN 


LTIVRAS 


IIVOPN 


IIVIS 


ITIVRTE 


TIVPCE 


(Part 3 of 5). 


Use of Macro 


Issued to selectively bring staged 1/0 
modules into main storage when staged 
I/O is requested, depending on the unit 


record device type in the DOS PUB table. 


Issued to load IIVACI, IIvpcrI, and 
IIVSCI, IIVRCW, user exit routines. 


Issued to load Emulator modules. 
Issued to load ITIVRAS. 

Issued to fetch volume-sharing modules. 
Issued to load IIVSNP and TIVRCP. 


Issued to load IIVMG1, IIVMG2, and 
LIVMG3. 


Issued to load IIVRAS. 


Issued to examine and modify the DSCBs 
associated with a sequential DASD or 
direct-access data set located ona 
shared volume. 


Issued after a DOS OPEN macro has 

been trapped by IIVGR2 for a sequential 
DASD or direct-access data set residing 
on a shared volume. 


Issued to open OS indexed sequential 
data sets. 


Issued to open DOS residence file if it 
shared. 


Issued to open the SYSDEBUG data set. 


Issued to open a DCB with a ddnare of 
SYSNAP. 


Issued to open the SYSSNAP data set. 


Issued to open sequential DASD and 
direct-access data sets (TYPE=J 
specifies that the Emulator's JFCBs 
are already in main storage). 


Issued to open an OS indexed sequential 
data set for initial loading of that 
data set. 


Issued by the timer interrupt check 
subroutine to set a completion code 
in an FCB. The completion code 
indicates that a time interval of 1 
second, established with an STIMER, 
has expired. 


is 


Issued to initiate subtask processing for 


IIvis. 


OS Macros Used by the Enrulator 
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OS Macro 


PUT 


PUTX 


RDJFCB 


READ KU 


RETURN 


SAVE 


SETL 


SNAP 


STAE 


Figure 80 


Emulator module 
issuing macro 


IIVts 


TIVSTG 


TIVIS 


TIVIS 


LIVOPN, 
LIVINT 


ITViIs 


lIvis, 

TIVRAS, 
IIvvio, 
TIVGR2, 
1IVSTG, 
IIVIN2, 


LIVENT, 


TIVIS, 


IIVINT, 
IIVSNP, 
IIVMSG, 
IIVABN, 
TIVPUB, 
LIVPRP 


IIVINT, 


LIVIS, IIVSNP, 


IIVRCP, 
livvio, 
TIVSTG, 
TIVPUR, 
TIVIN2, 
LIVGET, 
TIVABN 


ITIVis 


IITVABN 


TIVSNP 


ITIVRTE 


(Part 4 of 5). 


IIVRAS, 
TIVMSG 

IIVPRP, 
LIVccW, 
TIVADD, 
IIVOPN, 
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Use of Macro 


Issued to signal the completion of 
subtask processing to the Emulator 
task. 


Issued on behalf of DOS output 
requests when staging has been 
indicated. The output operation is 
always to an OS DPASD. 


Issued to store records in ascending 
order by key to an OS indexed 
sequential data set. 


Issued to rewrite sequentially 
retrieved records to an OS indexed 
sequential data set. 


Tssued so that these modules can 
examine and modify the JFCBs. 


Issued to retrieve records from an 
OS indexed sequential data set by key. 


Issued to restore register contents 
and return to the calling routine. 


Issued tc save contents of caller's 
registers. 


Issued to start sequential retrieval. 


Issued if the Emulator run must be 
terminated and if the JCL statement 
//SYSSNAP BD SYSOUT=A was included 
for the Emulator job step. The 
contents of the entire DOS storage 
area of the Emulator region and the 
DOS registers are dumped. 


Optionally issued to obtain a snap dump. 


Issued to enable the Emulator to retain 
control if an OS ABEND condition occurs 
because of an error in the DOS problem 
program so that DOS, not OS, can cancel 
the job. 


OS Macros Used by the Emulator 


Emulator module 


OS Macro issuing macro Use of Macro 
STIMER TIVRTE, YIVPUB Issued by the timer interrupt check 
subroutine and OS PUB table build 


routine to establish a time 
interval of 1 second if the user 
has requested that the Emulator 
Simulate the DOS timer. 


Upon expiration of this 1-second 
interval for the timer interrupt check 
subroutine, the CS control program 
passes control to the timer interrupt 
routine as soon as the Emulator becomes 
the highest priority task in the ready 
condition. Since the Emulator must 
compete with other tasks for control, 
the timer interrupt routine may not be 
entered immediately upon expiration 

of the 1-second interval. Also, it 

is possible that DOS external 
interruptions may be disabled when 

the interval expires. Consequently, 
the Emualator cannot simulate the 

DOS timer with strict accuracy. 


TIME TIVADD, IIVSNP, Issued to get the present OS date 
TIVRAS and time of day. 

WAIT IIVIN2, Iivis, Issued when processing cannot continue 
IIVOPN, ITVEPECE, until an interruption occurs. 


IIIVRTE, IIVRCP 


| WRITE TIVSNP Issued to dump Emulator control blocks. 
LIVRCP Issued to write the SYSSNAP data set. 
WRITE K, KN ILIVIS Issued to update and add, respectively, 


records to an OS indexed sequential 
data set. 


WTO, WTOR LIVMSG, TIVLOCG Used by the Emulator to issue messages 
for DOS and by IIVMSG to output 
Emulator messages. A DOS message is 
reformatted and issued as a WTO or WTOR 
by IIVLOG. 


Figure 80 (Part 5 of 5). OS Macros Used by the Emulator 


Bypass Label Processing 


See "Requesting Bypass Label Processing" in the "Introduction" for details. 


Access Methods 


For the indexed sequential access method (ISAM), module IIVIS is dependent 
on the location of the fields in the DCB, the DECB, and the JFCB. 
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Appendages 


Appendage modules IGG019SA and IGG019SI are used by the Emulator (see also 
"Emulator Appendages" in the Introduction and "I/O Appendages" in the Method 
of Operation section). These modules perform the following operations: 
IGG019SA 

e Updates DASD extents to inhibit automatic cylinder switching procedures. 


° Updates DASD extents to allow accessing of the user label track associated 
with a sequential DASD or direct-access data set on a shared volume. 


° Updates DASD file mask to reflect DOS file mask if the I/O is for a 
dedicated volume. 


e Updates tape set mode to reflect DOS set mode. 

® Issues store CPU ID instruction (STIDP). 

IGG019S1 

s Suppresses OS error recovery for teleprocessing I/0. 


od Suppresses OS error recovery for special tape operations (see IGG019S1 
module description). 


OS Control Blocks 


The OS control blocks in Figure 81 are referred to by the Emulator. This 
directory briefly describes how each block is used. The blocks are further 
described in the "Data Areas" section. 


control 

Block Field Displacement 

Name Name Decimal Hex Bytes Description of Use 

DCB DCBKEYLE 16 10 1 Contains the key length. 

DCB DCBEODAD 33 21 3 Contains the EODAD exit 
address. 

DCB DCBRECEFM 36 24 1 Contains the record format. 

DCB DCBDDNAM 40 28 8 Contains the DD statement 
data set name. 

CCB CCBIFLGS u44 2C 1 Indicates a permanent error 
condition when bits 0 and 1 
are on. 

DCB BCBOFLGS 48 30 1 Indicates a successful open 
when bit 3 is on. 

DCB DCBMACR 50 32 2 Contains the macro instruction 
operation code. 

DCB DCBOPTCD 52 34 1 Contains the option code. 


Figure 81 {Part 1 of 5). OS Control Blocks 
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Control 
Block 
Name 


DCB 


DCB 


DCB 


DCB 


DCB 


DCB 


DCB 


DCB 


DEB 


DEB 


DEB 


Figure 31 


Field 
Name 


DCBMAC 


DCBSYNAD 
or 


DCBS YNAD 


DCBRKP 


DCRBLKSI 


DCBEXCD1 


DCBEXCD2 


DCBLRECL 


CCBTDC 


DCBRORG3 


DCBNREC 


CCBLPDA 


DCBRORG2 


DC BNOREC 


DCBRORG1 


DEBEOEA 


DEBSTOA 


DEBCEA 


Displac 
Decimal 


53 


56 


57 
60 


62 
80 
81 
82 


148 


152 


156 


184 


206 


214 


224 
-36 
=3y 


-24 


{Part 2 of 5). 


ement 
Hex Bytes 
35 1 
38 4 
39 3 
3c 2 
3E 2 
50 1 
51 1 
52 2 
95 2 
98 4 
9c 4 
DB 8 
CE 2 
D6 2 
EO 2 
-24 4 
-20 ¥ 
-18 4 


CS Control Blocks 


Description of Use 

Contains extension of the 
macro instruction operation 
code field. 

Contains the SYNAD exit 
address. 

Contains the staged I/0 
SYNAD exit address. 


Contains the relative 
key position. 


Contains the blocksize. 
Contains condition flags. 
Contains condition flags. 
Contains the logical 
record length for variable 


length records. 


Contains the tag deletion 
count. 


Contains the count of accesses tc 


overflow records other than the 


first. 


Contains the number of 
logical records in the 
prime data area. 


Contains the direct-access 
address of the last prime 
data record in the prime 
data area, 


contains the number of tracks lef 


in the overflow area. 
Contains the number of 
logical records in the 
overflow area. 


Contains the number of full 
cylinder overflow areas. 


contains the end-of-extent 
appendage address. 


Contains the SIO appendage 
address. 


Contains the channel end 
appendage address. 
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Control 
Block 
Name 
BEB 


DEB 


DEB 


DEB 


CECB 


DECB 


DECB 


DECB 


DECB 


DECB 


DSCB 


DSCB 


DSCB 


DSCB VTOC 
{Format 4 


DSCB 


Field 
Name 
DEBXCEA 
DEBDVMOD 


DEBBINUM 


DEBSTRCC 
DEBSTRHAH 
DEBENDCC 
DEBENDHH 
DEBNMTRK 
DEC BDCBA 


DECBAREA 


DECBLOGR 


DEC BKEY 


DECBEXC1 


DECBEXC2 


DSTFMTID 


DS1DSIND 


DSIPTRDS 


) 


DS4DSREC 


Displacement 
Decimal Hex Bytes 
~20 -14 4 
32 20 1 
36 24 2 
38 26 2 
40 28 2 
42 2A 2 
ay 2c 2 
46 2E 2 
8 8 4 
12 Cc 4 
16 10 4 
20 14 4 
24 18 1 
25 19 1 
44 2c 1 
93 5D 1 
135 B7 5 
0 0 uy 
59 32 2 


Figure 81 (Part 3 of 5). 
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OS Control Blocks 


Description of Use 


Contains the abnormal end 
appendage address. 


Contains the file mask. 
The SIO appendage modifies fields 
to extend the extent to cover the 


entire DASD volume (for dedicated 
volumes only). 


Contains the number of tracks 
allocated on the volume. 


Contains the address of the 


DCB. 


Contains the address of the 
area in storage for the 
record. 


Contains the address of the 
logical record (also used by IIVIs 
in QISAM mode to store the current 
logical record). 


Contains the address of the 
key portion of the record. 


Contains the exceptional 
condition code. 


Contains the exceptional 
condition code. 


Contains the format identifier 
{X'F1!' identifies this as (format 1) 
DSCB) . 


Contains data set indicators 
in bits 0, 2, 3, and 5. 


contains the pointer to an 

index (format 2) DSCB, if data 
set has IS organization, or 
pointer to an extension (format 3) 
DSCB if data set has sequential 
or direct-access organization and 
more than 3 extents. 


Contains padding bytes. 
Contains the number of 


availakle free VTOC record 
(format 0) DSCBs in the vVToc. 


Control 
Block 
Name 


DSCB 


DSCB 


DSCB 


IOB 


IOB 


IOB 


TOB 


IOB 


IOB 


IOB 


IOB 


IOB 


JFCB 


JFCB 


JFCB 


Field 
Name 


DSavToc!i 


DS&4DEVDT 


DS4VTOCE 


IOBFLAG1 


IOBSENO 


IOBSEN1 


LOBECBPT 


TOBCSW 


IOBSTART 


ITOBDCBPT 


TOBSEEKM 


IOBSEEK 


JFCBDSNM 


JPCBTSDM 


JFCBLTYP 


Displacement 
Decimal Hex 
58 3A 
74 HA 
105 69 
0 9 
2 2 
3 3 
5 5 
9 9 
17 11 
21 15 
32 20 
33 21 
0 0 
52 34 
66 42 


Figure 81 (Part 4 of 5). 


Bytes 


10 


44 


OS Control Blocks 


Description of Use 
Contains VTOC indicators. 
contains the number of 
full DSCBS that can he 


held on one track. 


Contains extent description 
of the VTOC. 


Bits 0, 1, and 6 are set as 
required by EXCP [data 


chaining, command chaining, and 


related bit). 


Sense byte 1 is tested or 
passed to DOS (see TIVCHK 
for details). 


Sense byte 2 is tested or 
passed to DOS (see TIVCHK 
for details). 


Contains the address of 
the ECR. 


When I/0 interruptions 

are simulated, the 7 
low-order bytes of the 
last CSW are passed to DOS. 


Initialized with the first 
CCW for EXCP. 


Initialized with the DCB 
address for EXCP. 


M = the number of DEB extents 
as required by EXcP. 


BBCCHHR = the seek address 
for a direct-access volume. 


This field is modified so 
that the VTOC can be 
opened. The tenth 
character is examined to 
determine SYSIN and SYSOUT 
files for staged devices. 


SYSIN or SYSOUT file is 
assumed if X'20' is set 
in this byte. 


Set to X*'10" to assure 


BLP (bypass label 
processing) option. 
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control 
Block Field Displacement 
Name Name Decimal Hex Bytes Description of Use 


JFCB JFCBLKSI 102 66 2 contains a default block- 
Size for staged I/O if 
not specified in the DD 
statement (89 bytes for 
punch, 141 for print). 


JFCB JFCBVOLS 118 76 6 The Emulator open routine 
moves in the volume serial 
number or identification 
{VOLID) for mount requests. 


Used to locate the TIOT 
by means of EXTRACT. 


TIOT TIOELNGH 0 0 1 Contains the length of each DD 
entry. Used to scan the TIOT 
during initialization. 


TIOT TIOEFSRT 1 1 3 Contains the UCB address 
of the device allocated. 


TIOT TIOEDDNM 4 4 8 Contains an 8-byte DDname 
used to determine DOS units. 


UCB UCBTYP 16 10 4 Used to identify device 
types for cross-referencing 
with DOS device types. 
The SIO appendage modifies 
the DEB based on device 
type. The abnormal end 
appendage determines whether 
OS or DOS is to handle I/0o 
errors, based on the device type. 
UCB DCELBBNR 56 38 3 Bin number for a data cell drive. 


Figure 81 (Part 5 of 5). OS Control Blocks 


Dependence on Hardware 
The Enmlator depends upon hardware for information as follows: 


e PSW - The system mask field in the program status word is used to determine 
whether DOS is enabling interruptions. 


The WP bits (18-15) are tested by the Emulator to determine wait or problem 
state. 


The interruption code bits (16-31) are used by the Emulator to store the 
channel and device address when simulating an I/O interruption. 


The condition code bits (34-35) are modified by the Emulator. 


e CAW - The key and address fields in the DOS channel address word are 
accessed by the Emulator. 


° CSW - All fields in the channel status word are used or tested by the 
Emulator. 


The formats of the above words can be found in the "Data Areas" section. 
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EMULATOR SERVICE AIDS 


Some of the problems that might cause a DOS program to he canceled may he due 

to violations of the Emulator restrictions such as a CCW modified by DOS between 
the issuance of an EXCP and WAIT macros. The service aids may help in 
confirming the suspected cause of the problem by providing a dump at the time 
the violation occurred. 


The Emulator contains certain modules (IIVRAS, IIVRCP, IIVSNP, IIvPct, IIvsct, 
ITIVACI, IIVRCW), referred to herein as the service aids, that enable the 
installation systems prcegrammer or the IBM programming systems representative 
to localize problems that might occur during emulation. 


The service aids enable the Emulator to: 


e issue a dump of all or part of the Emulator region when specific events 
occur 


e trace specific events and record them in a variable size trace table 

e give control to user exit routines when specific events occur 

An additional 14K bytes of storage plus BSAM storage requirements are needed 

in order to utilize the service aids. BSAM storage requirements can be computed 
by referring to Storage Estimates for OS or OS/VS. The DCB parameters used 

for the output data set are DSORG=PS, MACRF=W, RECFM=VBA. Buffering is simple, 
scheduling is normal, and output goes to a CASD without record overflow. 

Before using the service aids, a review of "Hints for Debugging" and Emulator 
limitations and restrictions in the "Introduction" may help localize a problem. 
It would also ke helpful to review the "Method of Operation" section of this 


publication. Note that the ccntrol blocks that appear in the formatted snap 
dumps can all be found in the "Data Areas" section. 


Use of the Emulator Service Aids 


The Emulator service aids can be invoked in one (or both) of two ways: 
e by replying DFBUG to an Emulator prompt message on the system console 


A reply of DEBUG to an Emulator prompt message causes the following message 
to be issued: 


IIV270A jobname ENTER OR CONTINUE CEBUG STATEMENT 
The debug statement may then be entered on the console and when ccmpleted 
(as indicated by the END command), the Emulator prompt message is reissued 
and emulation resumes. 

e by including a //SYSDEBUG DD * card with the Emulator job step 
A debug statement that is entered through the OS input stream may span 


1 or more cards and must be immediately preceded by a //SYSDEBUG DD * card 
and followed ky a /* card. 
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A SYSSNAP DD statement, such as //SYSSNAP DD SYSOUT=A, must be included to 
define an output data set. This data set will contain: ) 


e the debug statement (s) entered during emulation and error messages 
associated with it (if any) 


e the formatted snap dumps requested 


e the trace table (if specified) containing the events recorded before the 
Emulator's termination 


If both snap dumps and a trace table are specified, a trace table containing 
the events recorded at the time the snap is taken will be printed with every 
snap dump. 


The Debug Statement 


A debug statement can be written in free form, that is, it need not begin in 

a particular column and it may contain any number of blank characters between 
elements and/or delimiters (commas, parentheses, equal signs) of the statement. 
Debug statements can contain commands, parameters, keyword parameters, and 
keyword subparameters. Each keyword parameter or keyword subparameter must 

be followed by an equal sign and its corresponding value or values. 


There are six commands: SNAP, TRACE, STORAGE, EXIT, DIAG, and END. Each 
command, with the exception of END, must contain at least cne parameter or 
keyword parameter. The ccmmands, parameters, or keyword parameters may appear 
in any order in the debug statement, but a keyword subparameter must follow 
its associated value. If more than one parameter or keyword parameter is 
entered in a debug statement, the parameters must be enclosed in parentheses. 


A debug statement is compcsed of: > 
debug statement = [{ ]{ commandi[{ ,command2,...) ], JEND 

parameter parameter2 
command = [ (] or [9 or pees) | 

keyword parameter’ keyword parameter2 


keyword parameter=[ (]Jvalue[ ,keyword subparameter1 [,keyword sukparameter2, 


sie 1 epee) 


keyword subparameter = [ (]valuel[ ,value2,...) ] 


Whenever a keyword parameter is repeated within a single debug statement, only 
the last keyword parameter specified will be in effect. For example, 


SNAP = (SVC =2, SVC =4), END 
causes a SNAP to be taken only when DOS issues an SVC 4 since the first keyword 
parameter (SVC=2) is overridden by the second keyword parameter. Each time 
a command is repeated in a statement (with the exception of FND) the first 
command is overriden ty the second. A SNAP would ke taken for each I/0 
operation on cuu=132, but not for each SVC 2 in the following example: 

SNAP = (SVC =2), SNAP = (I0,CUU= 132), END 


Figure 82 shows how to code a debug Statement. 
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CODE KEYWORD CODE KEYWORD 
PARAMETER = SUBPARAMETER = 


CODE ( IF MORE 
THAN ! VALUE CODE 
CODE END AND/OR_ KEYWORD THAN 


SUBPARAMETER 


KEYWORD 
SUBPARAMETER 


{ 
I 


IF MORE 
VALUE N 


CODE COMMAND = IS THIS A VALUE 
OR_A KEYWORD 


SUBPARAMETER 


CODE VALUE N 


CODE ‘ |1F MORE 
THAN 1 
PARAMETER 


ANY OTHER 
VALUE N 


CODE VALUE 


KEYWORD 


IS_THIS 


A_PARAMETER PARAMETER CODE ) IF MORE 
OR KEYWORD ANY OTHER THAN 1! VALUE N 
PARAMETER VALUES OR KEYWORD 

SUBPARAMETERS 


PARAMETER 


CODE } IF MORE 
THAN | VALUE 


CODE THE 
PARAMETER ANOD/OR_ KEYWORD CODE yg 


SUBPARAMETER 


ANY OTHER 
PARAMETERS 


YES 
CODE y 


NOTE: VALVE IS _A_COMPONENT 
OF THE KEYWORD PARAMETERS 
VALUE _N IS A COMPONENT OF THE 
KEYWORD SUBPARAMETER. 


CODE_) IF MORE 
THAN 1 
PARAMETER 


CODE 4 


Figure 82. How to Code a Debug Statement 
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Some points to consider when coding a debug statement are: 


492 


The debug statement may be contained in more than one card or console 
reply. ‘In this case; 


Te The statement can only be interrupted after a comma. Statements can 
only be interrupted when a comma follows a parameter or keyword 
parameter and its corresponding value, or a keyword subparameter and 
its corresponding value. 

26 If the service aids are invoked by including a //SYSDEBUG DD * card, 
the next record of the data set defined by the DD statement is read 
and processed. 


3. If the service aids are invoked by replying DEBUG to an Emulator 
prompt, the mesSage 


IIV270A jobname ENTER OR CONTINUE DEBUG STATEMENT 

is issued and the reply is read and processed. 
The end of a debug statement is indicated by the END command. When an 
END command is encountered following other debug commands, functions defined 
by the other debug commands, such as SNAP and TRACE, are activated. When 
an END command is encountered and is the only command in the DEBUG 
Statement, all the existing functions, if any, are inactivated. 
The options specified in the debug statement remain in effect until a new 
debug statement is entered through the system console or until the end 
of the Emulator job. 


Whenever a PHASE keyword subparameter is identified, all values encountered 
are processed; thus, 


SNAP = (SVC =4, PHASE=A, PHASE= (B,C)),END 


will cause a SNAP to be taken when DOS issues an SVC 4 to load A, B, or 
Ce 


If an error occurred when entering the debug statement on the console, 
the following message will be issued 


IIV271A jobname CEBUG COMMAND ERROR AT POSITION xxx-RESPECIFY 


The debug statement may be reentered with the command in error or the 
entire statement may ke respecified. 


If any errors are detected when input is from the data set defined by the 
SYSDEBUG DD statement, the message 


TIV2741 jokname 


is issued and emulation is terminated. 
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° If a syntax error is detected during the processing of a debug statement 
from the console, all functions, if any, are inactivated only for the 
command being processed. For example, if 

TRACE=ALL, SNAP= (SVC=2,END 
is issued from the console, an error message 

IIV271A jcbname 
is issued (END in the example is interpreted as an incorrect parameter 
for the command SNAP since there is no closing parenthesis before the 
second comma). Only the command in error (SNAP in this example) and any 
subsequent commands (END in this example) must be correctly respecified 
to be processed. In the above example, a reply 

SNAP = {SVC =2), END 
will cause a TRACE to be taken and a SNAP to be issued when DOS issues 


an SVC 2. If cnly END were respecified, only the TRACE command would be 
activated. 


TRACE Command 


The format for a TRACE command is 


parameter 1 parameter2 
TRACE = [ (Jor {,or zene) ] 
keyword parameter t=valuel keyword parameter2=value2 


See also "Trace Table" for further information concerning the function of this 
command. 


The following are valid parameters or keyword parameters of TRACE. Only the 
keyword parameters NUMBER and CUU have values. 


ALL When ALL is specified, all of the events caused by the following 
parameters or keyword parameters are recorded in the trace table as 
they occur. 


ATTN If the attention bit is set in the CSW, the cuu, the PSW at the time 
of interruption and the CSW are recorded in the trace table. If the 
unit check bit is set in the CSW, the two IOB sense bytes are also 
recorded. This parameter is recorded in the trace table (see Figure 
86 (Part 6 of 7). Service Aids Snap Dump) as: 


ATTN cuu IPSW hhbbhhhh thhhhhhh CSW hhhh hhhh SNS hhhh 


cuoU = [(] cuu [ ,cuu,...) ] 
Events associated with I/O operations will only he recorded 
in the trace table if the operation is to the specified 
channel and unit. These events include SIo, TIO, TCH, HI0o, 
and I/O interruptions. 


EXT When an interruption is external or the DOS interval timer occurs, 
the PSW at the time of interruption is recorded in the trace table 
(see Figure 86 (Part 6 of 7). Service Aids Snap Dump) as: 


EXT TPSW hhhh0040 hhbhhhhhh 
TMR IPSW hbhhh0OO80 hhkhhhhh 
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HIO 


INT 


TO 


ISK 


LPSW 


NUMBER 


SIO 
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When a halt I/0 instruction is issued by DOS, the cuu, the resume 

PSW, and the CSW are recorded in the trace table. In addition, if 

the unit check bit is set in the CSW, the two IOB sense bytes are 

recorded. This parameter is recorded in the trace table (see Figure ) 
86 (Part 6 of 7). Service Aids Snap Dump) as: 


HIO cuu RPSW hhhbhhhh bhhhhhhh CSW bhhbhhhh hhhhhhbhh SNS hhhh 


When INT is specified, I/O interruptions, external interruptions, 
and timer interruptions are recorded in the trace table. See also 
the parameters I0, EXT, and TIMER for further information. 


All interruptions associated with I/O operations are recorded in the 
trace table. These include SIO, TIO, TCH, and HIC. In addition, 

I/O interruptions cause the PSW at interruption, the channel and unit 
address, and the CSW to be recorded in the trace table. If the unit 
check bit is set in the CSW, the two IOB sense bytes are also recorded. 
I/O interruptions are recorded in the trace table (see Figure 86 {Part 
6 of 7). Service Aids Snap Dumr) as: 


I/O cuu IPSW hhhbbhhh hhbhhhhh CSW hhhhbhkEh hhhhhhhh SNS hhhh 


When an insert storage key instruction is issued by DOS, the PSW at 
interruption, the storage address of DOS, and the storage protection 
key are recorded in the trace table. This parameter is recorded in 
the trace table (see Figure 86 (Part 6 of 7). Service Aids Snap Dump) 
as? 


ISK IPSW hhhhhhhh hhkhhhhh ADDR 11111111 KEY h 


When a load PSW instruction is issued by DOS, the PSW at interruption 
and the resume PSW are recorded in the trace table (see Figure 86 
{Part 6 of 7). Service Aids Snap Dump) as: 


LPSW IPSW hrhhhrrh hkhhhhhh RPSW bhhhhhhh hhbhhhhh ) 


{50} 


{nnnnn} 


This keyword parameter is used to redefine the default trace table 
Size. If NUMBER is not specified, the default value is 50. The 
maximum number of entries is 65,534. As each entry is 36 bytes in 
length, any significant increase in the table size should be reflected 
in the jok step region parameter. 


When a start I/O instruction is encountered, the information recorded 
in the trace table depends on the condition code and the type of 
device. If the device type is direct access, the DASD seek address 
will be recorded. If cc=01 (CSW stored) and the unit check bit is 
not set in the CSW, the cuu, the RPSW, the CSW, and the CCW addressed 
by the DOS CAW (for staged or SYSLOG devices, or if the operation 

is a stand-alone sense or seek) are recorded in the trace table. 

If, however, the device is not staged or SYSLOG, or if the operation 
is not a stand-alone sense or seek, the CCW address is obtained from 
the COMCAW field of the COMTAB entry for that device. This parameter 
is recorded in the trace table {see Figure 86 (Part 6 of 7). Service 
Aids Snap Dump) as: 


SIO cuu SEEK hhhhhhhh bhhhbhhh RPSW hhhbhhhhh hbhhhbhhhh 


CAW bhhhhhhh CcCW1 hhhhhhbh khrhhhhh 
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SSK 


SSM 


svc 


If cc=01 and the unit check bit is set in the CSW, the cuu, RPSW, 
CSW, the operation code of the CCW referred to above, and the first 
two sense bytes obtained from the IOB are recorded in the trace table 
(see Figure 86 (Part 6 of 7). Service Aids Snap Dump) as: 


STO cuu RPSW hhhhhhhh hbhhhhhhh CSW hhhhhhhh hhhhhhbhh 
SNS bhhh OP hh 


If cc#01, the cuu, RPSW, CAW, and either the first CCW or the cCcwW 
pointed to by the COMCAW field in COMTAB (depending on the same device 
types and operations noted previously) are recorded in the trace table 
(see Figure 86 (Part 6 of 7). Service Aids Snap Dump) as: 


SIO cuu RPSW hhhhhhhbh hhhhhhhh CSW hhhhhhhh hhhhhhhh 
CcCWi hhhhhhbh hkkhhhhh 


When a set storage key instruction is issued by DOS, the PSW at 
interruption, the storage address, and the storage protection key 

are recorded in the trace table (see Figure 86 (Part 6 of 7). Service 
Aids Snap Dump) as: 


SSK IPSW hhbhhhhh hhkhhhhh ADDR 11111111 KEY h 


When a set system mask instruction is issued by DOS, the PSW at 
interruption and the resume PSW are recorded in the trace table (see 
Figure 86 (Part 6 of 7). Service Aids Snap Dump) as: 


SSM IPSW hhhhhhhh hhhhhhhh RPSW hhhhhhbh hhhhhhhh 


When a supervisor call is issued by DOS, the PSW at interruption and 
the contents of DOS general purpose registers 0 and 1 are recorded 
in the trace table. In addition, if the interruption is not taken 
(in other words, if the function of the DOS SVC routine is performed 
by the Emulator), the resume PSW is also recorded in the trace table. 
If the SVC is 2 (DOS fetch), the name of the DOS B-transient phase 
is recorded. If the svc is 4% {DOS load), the name of the DOS load 
module is recorded. This keyword parameter is recorded in the trace 
table (see Figure 86 (Part 6 of 7). Service Aids Snap Dump) as: 


Svc nnn IPSW hhhhhhhh hhhhhhhh RPsW hhhbhhhbhh hhhhhhhh BIR ccccccce 
RO hbhhhhhh R1 ftkhhhhhh 
SVC nnn IPSW hhhhhhhh hhhhhhhh LDMD cececcec RONKhHHhbhhhh 


R1 hkbhhhhhh 


svc =[{(]) n {[-n,-.--) }} 


TCH 


TIMER 


n This value of the SVC keyword parameter is the supervisor call 
number for which entries will be made in the trace table. The 
value n represents a decimal number from 0 to 255. 


When a test channel instruction is issued by DOS, the cuu and the 
resume PSW are recorded in the trace table (see Figure 86 (Part 6 
of 7). Service Aids Snap Dump) as: 

TCH cuu RPSW hhhhhbhhkh hhhhhhhh 

When an interrurtion due to the emulated DOS interval timer occurs, 
the PSW at interruption is recorded in the trace table (see Figure 
86 (Part 6 Of 7). Service Aids Snap Dump) as: 


TMR IPSW hhbhhhhh hhbhhhhh 
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TIO When a test I/0 instruction is issued by DOS, the cuu, the resume 
PSW, and the CSW are recorded in the trace table. In addition, if 
the unit check bit is set in the CSW, the two IOB sense bytes are 
recorded. This parameter is recorded in the trace table {see Figure 
86 {Part 6 of 7). Service Aids Snap Dumf) as: 


TIO cuu RPSW bhkhhhhbh hkhhhhhh CSW hhbhhhhhh hhhhhhhh SNS hhhh 


WRAP WRAP is the default parameter of the TRACE command and will cause old 
NOWRAP entries in the trace table to be overlaid by new entries when the 
trace table is full. NOWRAP causes the trace table to be snapped every 
time it is full. 


Trace Table. The trace table is an optional feature specified by the command 
TRACE. The events to be traced are specified in parameters in the TRACE 
command. When the table is filled, old entries are overlaid with new entries, 
starting at the beginning address of the trace table. 


The trace table is printed along with the Emulator-formatted snap dumps as 
they occur. All trace table pointers are reset immediately after the TRACE 
table is printed. This ensures that no two formatted traces reflect the same 
events. If no snap dumps are taken, the trace table will be printed only once 
at Emulator end-of-job time. 


Unusual circumstances may cause abnormal termination of the Emulator region 
before the trace table is printed. Refer to Figures 83 and 84 for the procedure 
to locate and interpret an unformatted trace table. 


IIVCON 


IIVRCN 


RASTRCTB 
RASTRCMX |RASTRCNX 
RASTRCNO 


Trace Table 


X'464' ARASCONS 


Notes: 


The address of the Emulator service aids constants area (I1IVRCN) is located in a 4-byte field at X’464’ in IIVCON 

The address of the Emulator trace table is located in a 4-byte field at X'08’ in IIVRCN. 

The number of active trace entries is located in a 2-byte field at X’OC’ in IIVRCN. 

The address of the next available entry in the trace table is located by multiplying 36 (trace table entry length) times the value 
contained in the 2-byte field at X‘OE’ in IIVRCN and adding the result to the beginning address of the trace table. 

The size of the trace table in 36-byte entries is located in a 2-byte field at X’10’ in IIVRCN. 

The most recent entry in the trace table can be located by subtracting 36 from the address of the next available entry. 
Successive subtractions vield addresses of former entries. 


Figure 83. How to Locate the Trace Table 
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SNAP Command 


The format for a SNAP command is ; | 
parameter! J 
SNAP = { (] or 


keyword parameter 1l=valuel[ ,keyword sukparameter 1=va lue2 


peor) J 
{,keyword subparameter2=value3,... ] 


The following parameters, keyword parameters, keyword subparameters, and 
corresponding values of the SNAP command define the conditions under which 


an Emulator dump can be taken. 


ALL This parameter causes an Emulator snap dump to he taken, as described 
for all cther parameters or keyword parameters. 


ATTN This parameter causes an Emulator snap dump to be taken whenever an 


I/O interruption is simulated to DOS and the attention bit is set 
in the DOS CSW. 


{A111111 =} 


COMP = [ (] (Rnn =} (h}[ (h} fh} [h} (h} [h} {h} fn} J [E,---) ] 
{CRnn =P CFPC UE UT U8) 08) 042 18d ee 
1 This digit represents a DOS local address in main storage whose 


contents will be compared with the corresponding data as shown 
by values replacing h. Leading zeros are not required for the 


address. 


an address in main storage. The main storage addressed by the 


Rnn This value represents a DOS general furpose register that contains 
indicated register will be compared with the corresponding data. J 


CRnn This value indicates that the contents of the indicated DOS 
general purpose register is to be compared with the corresponding 


data. 


nn This value can be one or two digits representing any decimal 
value from 0-15. 


* The * indicates that the corresponding four bits in the same 
position are not to be examined. 


h The h represents the data to be compared and can be any valid 
hexadecimal digit from 0-F. The data can be any valid combination 
of hexadecimal digits or *'s, up to a total of 8 digits (4 bytes). 


The effective length of the compare field for A111111 and Rnn will 
only be as long as the number of digits provided. In the case of 
CRnn, leading zeros are padded to the left. 


Note: If the debug statement 
SNAP = COMP = A0020 = O£40, END 


were coded, an Emulator snap dump would be taken if DOS storage 
locations 20 and 21 contained the hexadecimal values of OF and 40, 
respectively. If, however, this condition is met while DOS is in 
local execution mode and the values in storage locations 20 and 21 
are then changed prior tc a hardware interruption, the condition will 
never be detected by the Emulator and thus no snap dump will be taken. 


@ 
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EXT 


HIO* 


INT 


Io 


PSW = 


{ (] cuu [ ,cuu,...) ] 

This keyword parameter causes an Emulator snap dump to be taken 
only for the channel and unit specified for I/O related 
instructions and interruptions. 


This parameter causes an Emulator snap dump to be taken whenever an 
external interruption is simulated to DOS. 


This parameter causes an Emulator snap dump to be taken whenever DOS 
issues a halt I/O instruction. 


This parameter causes an Emulator snap dump to be taken for I/O, 
external, and timer (asynchronous) interruptions. 


This parameter causes an Emulator snap dump to be taken whenever DOS 
issues the SIO, TIO, HIO, or TCH instructions. In addition, a snap 
dump will be taken for all I/O interruptions. 


This parameter causes an Emulator snap dump to be taken whenever DOS 
issues an insert storage key instruction. 


This parameter causes an Emulator snap dump to be taken whenever DOS 
issues a load PSW instruction. 


{NOI PL} 
{ALL} 


This keyword parameter causes an Emulator snap dump to be taken 
whenever a nonprivileged operation program check occurs. If the 
problem state bit was set in the local execution PSW when the 
privileged operation occurred, a snap dump will also he taken. If 
PC without operands or PC=NOIPL is specified, program checks during 
DOS IPL are ignored. If PC=ALL is specified, program checks will 
also be snapped during DOS IPL. The SPACE parameter should then be 
included in the SYSSNAP DD statement since there is a fairly large 
volume of output. 


(n}{ fh} {h} (h} [h} Ch} (h} (h} {h} Ch} (h} {hh} {h} (h} fh} Ch} 
(HYD OF} OD OED OS OD OD 


* The * indicates that the corresponding four bits in the same 
position of the local execution PSW are not to be examined. 


h The h can be any valid hexadecimal digit from 0-F. 


Digits and *'s can be placed in any order. If fewer than 16 characters 
are specified, *'s are padded to the right up to a total of 16. In 
other words, the remaining digits in the local execution PSW are not 
examined. 


The local execution PSW is examined before passing control to DOS. 

An Emulator snap dump will be taken if there is an equal compare 
between all the indicated fields to be examined (as specified by valid 
digits in place of h) and those in the local execution PSW. 


Note: If all the characters are *'s, a snap dump will he taken every 
time control is passed to DOS. 


This parameter causes an Emulator snap dump to he taken whenever DOS 
issues a start T/0 instruction. 


This parameter causes an Emulator snap dump to be taken whenever DOS 
issues a set storage key instruction. 


This parameter causes an Emulator snap dump to be taken whenever DOS 
issues a set system mask instruction. 
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SVC = [{] n {[-m,---) J} 
{[ ,N,geoee,PHASE =[ (] modnamel [,modname2,...) ])[,--- ]} 


n This value is the supervisor call number for which snaps 
are to be taken. 


PHASE This keyword sukparameter indicates that snaps are taken 
only if specific DOS B-transient phases and load modules 
are being fetched or loaded. PHASE is valid only if the 
SVC number is 2 or 4 and immediately precedes PHASE. 


modname This value may be any combination cf alphameric characters 
or %, up to a total of 8 characters. If less than 8 
characters are specified, the name will be padded right 
with blanks to 8 characters. 


An Emulator snap dump is taken if the indicated SVC interruption 
occurs. If the PHASE keyword sukparameter was specified, snaps are 
taken only if DOS register 1 roints to one of the indicated module 
names at the time the indicated SVC interruption occurs. 


TCH* This parameter causes an Emulator snap dump to be taken whenever DOS 
issues a test channel instruction. 


TIMER This parameter causes an Emulator snap dump to be taken whenever an 
interval timer interruption is simulated to DOS. 


TIO* This parameter causes an Emulator snap dump to be taken whenever DOS 
issues a test I/O instruction. 


°e 
* Another dump is issued after the Emulator has simulated the instruction. 


STORAGE Command 


The format for a STORAGE command is 


parameter {,parameter2,...) ] 
STORAGE = [{(] or 
keyword parameter=value 


The following parameters and keyword parameter of the STORAGE command define 
the main storage to be dumped whenever a snap dump is taken. The parameters 
may be specified in any order. 


ALL This parameter causes the OS SNAP macro to be issued (SDATA=ALL) in 
addition to the formatted dump of the Emulator control blocks, which 
is printed whenever a snap dump is taken. 


DOS This parameter causes the DOS registers and entire DOS main-storage 
area to be dumped whenever a snap dump is taken. (DOS is the default 
value if STORAGE is not specified.) 


EMBLKS This parameter causes a formatted dump of the Emulator control blocks 
to be printed whenever a snap dump is taken. (EMBLKS is the default 
value if STORAGE is not specified.) 


EMU This parameter causes the OS SNAP macro to be issued (PDATA=ALL) in 
addition to the formatted dump mentioned previously. 


NODOS This parameter causes the DOS registers and only the DOS permanent 
storage area to be dumped whenever a snap dump is taken. 
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J 


NUMBER = 50 
nmnnnn 


This keyword parameter defines the number of snaps to be taken (maximum 


number is 65,534}. Snap dumps are bypassed when this value is reached. 
If NUMBER is not specified, the default value is 50. 


EXIT Command 


The format for an EXIT command is 
EXIT = { (] keyword parameter t=valuei[ ,keyword parameter 2=value2,...) ] 


The EXIT command allows user-written routines to be given control at various 
points during the emulaticn process. 


Before the user routine can be executed, it must reside on the system program 
library (SYS1.LINKLIB) or on a private library. The full member name of the 
routine is 8 bytes in length, but the first 6 bytes are required to be the 
characters IIVRAS. The last 2 characters must be provided by the user as an 
identification (nn) and can be any two numeric characters. 


User-written exit routines can provide additional control when solving emulation 
problems. Emulatcr control blocks can be examined, as well as individual bit 
settings anywhere in the Emulator region. 


A user exit routine may receive control under the conditions described in the 
following keyword parameters and corresponding values. 


Refer to Figure 85 for overall control flow. 
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IIVRASYN2 A(IIVRASYN) 
IIVRASVC2 A(\IVRASVC) 
IIVRASPC2 A(IIVRASPC) 


EMUCONS 


IIVSNP IIVSCI INV PCI 


User Exit User Exit User Exit User Exit 
ASYNC SVC PC LEX 


IIVRTE IIVSVC IIVPCE 


IIVRTER2 
pO 
1 


The label for this address constant is ART20. This address constant is the return point for all Emulator modules. 


IIVACI 


O 

os po] 

‘ m = 
— 

4 


2These entry points are entered after the associated hardware interruptions have occurred. 


Figure 85. Control Flow of the Emulator Service Aids 
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A(IVACI) | 


U 


AS = nn An asynchronous interruption occurred while the CPU was in local 
execution mode. Control is passed to the asynchronous user exit 
routine before passing control to the Emulator (entry point 
IIVRTE). The nn is a 2-byte identification of an asynchronous 
user exit routine that has been entered on the system program 
library (SYS1.LINKLIB) or on a private library. 


LEX = nn Control is to be returned to DOS after a program check, supervisor 
call, or asynchronous interruption occurs. Control is passed 
to the local execution user exit routine before passing control 
to the Emulator (entry point IIVRTER2). The nn is a 2-byte 
identification of a local execution user exit routine that has 
been entered on the system program library (SYS1.LINKLIB) or 
cn a private library. 


PC = nn A DOS program check interruption occurred. This condition 
includes privileged operations, which will subsequently be handled 
by the Emulator. Control is passed to the program check user 
exit routine before passing control to the Emalator {entry point 
IIVPCE). Tke nn is a 2-byte identification of a program check 
user exit routine that has been entered on the system program 
library (SYS1.LINKLIB) or ona private library. 


svc = nn A DOS supervisor call interruption occurred. Control is passed 
to the supervisor call user exit routine before passing control 
to the Emulator (entry point IIVSVC). The nn is a 2-byte 
identification of a supervisor call user exit routine that has 
been entered on the system program library (SY¥YS1.LINKLIB) or 
on a private library. 

At entry to an exit routine, the contents of the registers are as follows: 

® Register 9 contains the address of the local execution list. 


e Register 10 contains the true address of the DOS main storage {adjustment 
factor). 


° Register 11 contains the address of IIVCON (EMUCONS). 

° Register 14 contains the return address. An optional snap dump will be 
taken if the user exit routine returns to the address in register 14 plus 
a displacement of 4. A zero displacement will cause a normal return. 


® Register 15 contains the address of the exit routine entry point. 


Standard linkage must be used. It is the responsibility of the user to ensure 
all registers are saved and restored. 


Note: The ddname for user data sets must start with the three characters SYS. 


Any other combination of characters will be interpreted as an erroneous volume- 
sharing request. 


CIAG Command 


The format for a DIAG command is 

DIAG = CCWCHK [=[ (]Jcuu[,...)]] 

One of the main restrictions of the Emulator is in running DOS programs which 
modify CCWs or use CCW data addresses between an I/O request and its completion. 


The result is unpredictable and could cause a loop in DOS as well as a DOS 
program check or an Emulator program check. The restriction is required because 
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the Emulator adjusts the DOS CCWs in place {in DOS main storage) and issues 
an OS EXCP against these CCWs. These CCWs contain OS (true) addresses from 
the time the OS EXCP is issued and the time OS posts I/0 completion in the 

ECB. 


The DIAG feature of version 2, level 1 of the Emulator allows removal of the 
restriction on programs using CCW data addresses (read only operations) during 
I/O requests. In addition, the DIAG command allows identification of DOS 
programs that modify the CCWs. 


Rather than adjusting the DOS CCWs in DOS main storage, a special module 
{IIVRCW) is loaded when the DIAG feature is requested. IIVRCW will copy the 
DOS CCWs in a special save area, adjust them to their OS addresses in this 
area (called the DIAG block) and allows the Emulator to issue I/O requests 
from this area only. 


The DOS CCWs in DOS main storage will remain unchanged between the I/O request 
and its completion. When IIVRCW readjusts the CCWs in the DIAG block back 

to DOS (local) addresses, a check will be made to determine whether the DOS 
CCWs have been modified by the DOS program from the time of the DOS SIO and 
the completion of the I/O as indicated by OS. If the CCWs have been modified, 
a message {IIV280I) will be issued to indicate which CCW has been modified. 

A channel program check is returned to the DOS program. 


How to Request the DIAG Feature 


CCWCHK [=[ (]cuu[,...) }] 


The cuu's specified indicate which DOS unit address will have the feature 
attached. If no cuu is specified, all the DOS unit addresses defined 
during the Emulation run (specified on SYSEMcuu statements) will have the 
DIAG feature except for staged devices and log devices. 


DIAG limitations: When the DIAG command is being processed by IIVRCP, a DIAG 
block is created for each cuu specified. The total length of the block is 
112 bytes (104 of these bytes will be used to save the DOS channel program). 
If a DOS channel program issued on a DOS unit with the DIAG feature contains 
more than 13 CCWs, message IIV281I is issued by module IIVRCW and the DIAG 
feature is reset for the DOS cuu involved. 


The Emulator region should contain enough space for the DIAG blocks and module 
IIVRCW plus the 11K required for the service aids function. 


END Command 


When coded with other debug commands, END indicates termination of the debug 
statement. When coded'as the only command in a debug statement, END will 
inactivate all previous functions, if any. 
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Examples of Valid and Invalid Debug Statements 


The following are valid dekug statements using one card/console reply: 

* ‘TRACE =«{EXT, NUMBER = (120)), END 
(At Emulator end of joh, a trace tahle of 120 entries will be written to 
the SYSSNAP data set. The trace table will contain DOS external 
interruption entries, if they occur.) 

e SNAP = COMP = A0020 = OF4OD, END 
{An Emulator snap dump will be taken if DOS storage locations 20 and 21 
contain the hexadecimal values of OF and 40, respectively. See also the 
note in the explanation of the keyword parameter COMP under the SNAP 
command. } 

° SNAP = (SVC = ((2, 3, 4,PHASE= ($S3BOPEN,$$BCLCSE)))),E£ND 
(An Emulator snap dump will be taken whenever DOS executes an SVC 2 or 
SVC 3. In addition, a snap dump will be taken by the Emulator whenever 
DOS executes an SVC 4 and DOS general rurpose register 1 points to either 
the phase name $$BOPEN or S$BCLOSE.) 

The following are valid debug statements using multiple card/console replies: 


* TRACE = (SIO, 
TIO), 


* SNAP = SVC = (1, 
2, END 


(DOS start I/O and test I/O instructions will be recorded in the Emulator 
trace table as they occur. Since the keyword parameter NUMBER was not 
included, a default value of 50 entries will be used.) 
(An Emulator snap will be issued whenever an SVC 1 or SVC 2 instruction 
is executed by DOS. If any start I/O or test I/O instructions were issued 
by DOS before the snap, the trace table will be included as part of the 
snap dump. If there are any entries in the trace table between the time 
the last snap dump was taken and Emulator end of job, the trace table will 
be snapped again at Emulator end of job.) 

The following are invalid debug statements using one card/console reply 

* TRACE = SIO, TIO, END 

(SIO, TIG are not enclosed in parentheses.) 


* SNAP = (SVC = (2), END 
{Unbalanced parentheses.) 


e SN AP = ALL, END 
(Blank embedded in SNAP.) 
The following are invalid DEBUG statement using multiple card/console replies: 


* SWAP = (ALL, SVC = (, 
2, 3)), END 


{Statements can only be interrupted when a comma follows a parameter, 


keyword parameter and its corresponding value, or a keyword subparameter 
and its corresponding value.) 
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Examples of Service Aids Usage to Diaqnose Problems 


Problem 1 ) 


Symptom: 


DOS program canceled due to a DOS program check or channel program check and 
a DOS storage dump is produced. 


Assumptions: 
The following assumptions are made in this example: 
1. The program check occurs only under emulation. 


2. The DOS Emulator restrictions have been reviewed for possible violation 
by the user program. 


Probable cause: 


With the symptoms and assumpticns listed above, the following causes are 
suspected; 


1. A DOS module is using the data address in a CCW that is currently active 
(for example a WAIT macro not issued to ensure I/O completion). This type 
of violation usually results in a variety of program checks, depending 
on the data address and its usage. In any case, it is desirable to obtain 
dumps and any other helpful diagnostic information at the time the symptom 
occurs. 


Code the following statement to obtain information that may help identify the 
cause of this problem. 


SNAP= (PC ,COMP=R14=35DE4) , END ) 
Explanation: 


Specifying Pc tells the Emulator to produce the desired dumps whenever a 
nonprivileged operation program check occurs. Specifying COMP=CR14=35DE4 tells 
the Emulator to produce the desired snap dumps whenever register 14 contains 
the value 00035DE4. The register and the value are arbitrary, but in this 
example the value may represent an adjusted data address from a CCW. 


If the suspected cause was responsible for the problem, the dumps produced 
should help reveal the DOS modules involved when the problem occurred and 
consequently help locate the code violating the restriction. 


2. A DOS module is modifying a CCW chain that is currently active. The 
modification involves the data address or the chaining bits. This violation 
usually results in a channel program check from the channel or from an 
Emulator simulation during CCW adjustment. 


By using the service aids, diagnostic information may be obtained before the 
channel program check is passed to DOS. Since the cause of the problem may 
be that the channel program is being modified, the only areas of interest are 
the Emulator control blocks (such as relative I/O blocks) and DOS storage. 
Therefore, the default STORAGE specifications will be used again and the 
following SNAP command will be used: 


SNAP=COMP=A45=20, END 
COMP=A45=20 tells the service aids to produce the required snap dumps when 
the contents of DOS location X'45* is equal to 20. Location X*'45*" is byte 


2 of the CSW status and hexadecimal 20 represents a channel program check. 
The dumps should aid in revealing the information in the following list. s 
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a. The channel program check was simulated by the Emulator (the status of 
the IOB does not indicate a channel program check). 


b. The channel pregram that caused the channel program check. 


c. The module involved in causing the channel program check, since the 
modificaticn occurred shortly before the dump. 


A more effective method of obtaining an Emulator snap dump could be employed 
if it can be determined exactly how the channel program is being modified. 
The COMP specification can then be used to compare with a specific CCW to 
obtain the dump closer to the time the CCW is being modified. If the chain 
bit is being moved or ORed in to add more CCWs to a CCW string, then the 
following SNAP command might be used to take a snap dump: 

SNAP = CCMP=A2340C=60C00000, END 


The following example shows a CCW in the CCW string before and after 
modification: 


Before modification: 


8602600420CCO0D0 


After modification: 


8602600860 CO0D0 


Problem 2 
Symptom: 


A DOS problem program is canceled due to an invalid direct-access seek address 
after the Emulator message IIV263I is issued. 


Assumptions: 

The following assumptions are made in this example: 
1. The program check occurs only under emulation. 
2. The volume involved in a nondedicated volume. 


3. The DOS supervisor was generated without the DASD file protection option. 


Probable cause: 


It is suspected that the DOS problem program is violating an Emulator 
restriction regarding nondedicated volumes. 


Service aids usage: 
The DOS message indicates the contents of the CSW, the address of the CCB and 


the seek address. If a DOS dump is not available, an Emulator snap dump can 
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be created at the time DOS issues the SIO. This is accomplished by coding 
the following debug statement: 


{sample statement 1) SNAP=COMP=A44=0E,STORAGE=ALL, END 2 


First identify the file involved; the CCB address should help to locate the 

DTF (in most cases, the CCB immediately begins the DTF). The DTF name can 
then be located and, in turn, be used to locate the corresponding DLBL/EXTENT 
cards. If they have been cataloged on the SYSRES label cylinder, the DOS LSERV 
program can be used. The DLBL/EXTENT cards will contain the 'file-id* of the 
file; and therefore, its ‘data set namet. The dsname is then used to locate 
the corresponding DD statement. 


In addition the DTF should indicate whether it has been opened by DOS {open 
bit on and volume sequence number and extent description initialized). 


Another way to check that DOS actually issued an open for the file is by coding: 
(sample statement 2) SNAP= SVC=(2, PHASE=$$BOPENR) , END 


An Emulator snap dump will be issued for each DOS open. No further debugging 
is required if it can be determined that a DOS open was never issued to the 
file in question, since a direct-access volume sharing restriction was violated. 


At this point, the DTF has been located, and the corresponding OS DD statement 
has been identified. The last snap dump issued by the Emulator (sample 
statement 1) lists the Emulator control blocks: 


® COMTAB extensions are listed immediately below their related COMTAB. To 
identify the associated CTEXT, match the DD name of the involved file with 
the name listed at the left of each COMTAB extension. 


CTDCBPTR (displacement 8 into the CTEXT) points to the related DCB. Then 
locate the CEB to find the actual extents of the file as allocated by OS. } 


° File identificaticn blocks (FIDBLK) are listed below their related COMTAB 
extensions. Verify that a FIDBLK has been created for the DTF {the DTF 
name is listed immediately to the left of each FIDBLK entry) for the 
executing DOS fartition. Displacement X*'13' into the FIDBLK contains the 
PID/PIK of the DOS partition issuing the open. 


At this point, the DCB and its related DEB have been located and it has been 
verified that the Emulator actually opened the corresponding OS file. 


The presence of message IIV263I indicates that the Emulator module IIVPcE did 
not find the given DOS seek address in any of the DEB*s attached to the 
corresponding COMTAB; additionally the Erulator module IIVVIO could not identify 
the channel program as one issued by specific DOS open routines to maintain 

the vToc. 


It must first be checked whether or not the I/O request came from the problem 
program either by looking in the snap dump created (sample statement 1 - the 
instruction address portion of the DOS SVC old PSW should point to the next 
sequential instruction after the DOS SVC 0 instruction) or by looking at the 
dump created by DOS (the PSW is listed immediately before the dump). 


An Emulator error can be suspected if the I/O request came from a B-transient 
phase and the seek address indicates either the volume label (cylinder 0, head 
0) or the vToc (the VTOC address should be set in the DTF). 


Since all Emulator processing for shared volumes is highly dependent upon DOS 
open phases, the DOS open phases and release number should be checked. The 
DOS Release number must he 25, 26, or 27 and the DOS open phases must not be 
modified by the installation. 
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A violation of an Emulator restriction can be suspected if the request came 
from a problem program. Some possible violations are: 


e The problem program is expecting an extent at a given address. Solution: 
The DD statement should contain absolute track allocation. 


e The problem program is expecting either: 


1. an extent larger than the one defined in the SPACE parameter of the 
DD statement 


2 an extent type which does not match the one given in the DD statement 
3. a total number of extents different than those provided. 


In all the above cases the DD statement must be modified to reflect an extent 
status compatible with the problem program before resubmitting the job. 


Interpreting Dumps 


The following explanation of the contents of an Emulator snap dump is 
interspersed with samples taken from a snap dump. Capital letters represent 
the headings found in all dumps and lower case letters represent information 
that varies with each dump. Each lower case letter used indicates the format 
of the information and the number of letters indicates the length. 

e h represents 1/2 byte of hexadecimal information 

e d represents 1 byte of decimal information 

e c represents 1 byte of character information 

° a represents 1/2 byte of information used for true addresses 


° l represents 1/2 byte of information used for local addresses 


REKKEKEKERKEKEEEKR AER EEKKEKE EKER EEKERE EERE EERE EKER ESL CEKEREEEKEKEEEKEEEEEEEEEKEEKEEES 


*** Fmulator Service Aids Requested** * 
* * 
*0S/360 DOS EMULATOR VERSION d LEVEL da TIME dddddd DATE ddddd PAGF ddda* 
* * 


*OPTION IN EFFECT option * 
TEeTCTTeTETT TIT TTT TTT TTT Te TT ttt TT TTP TTT eT Te Pt Tt ete ter Tet eee SPS ee Tee Sree eet eS oF 


Pigure 86 (Part 1 of 7). Service Aids Snap Dump 
**EMULATOR SERVICE AIDS REQUESTED** 

identifies the data that fcllows as debugging output. 
VERSION d 

is the version of the Emulator being executed. 
LEVEL d 

is the level of the Emulator being executed. 
TIME ddddda 


is the hour (first two digits), minute (second two digits), and second 
{last two digits) when the Emulator service aids routines began processing. 


DATE ddddd 


is the year {first two digits) and day of the year {last three digits). 
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PAGE dddd 


is the page number that appears at the top of each page. 
| ) 


OPTION IN EFFECT option 


510 


is the reason the snap dump was taken. The service aids SNAP options 
appear in the listing as follows: 


ecccc cuu SNAP 1 of 2 or cccc cuu SNAP 2 of 2 


where cccc is one of the following privileged instructions: 


e HIo - halt I/O instruction 

* ISK - insert storage key instruction 
° LPSW - load PSW instruction 

° SIO - start I/O instruction 

* SSK - set storage key instruction 

° SSM - set system mask instruction 

° TCH - test channel instruction 

TIO - test I/O instruction 


cuu is the channel and unit number of the DOS device. This field will 
appear only for an I/O related instruction. 


SNAP 1 of 2 
indicates that the snap dump was taken at the time of the hardware 
interruption and before control is passed to the Emulator. 


SNAP 2 of 2 
indicates that the snap dump is taken before passing control 
to a user local execution exit routine if one was specified. 


ATTENTION 
indicates that an I/O interruption was simulated to DOS and the 
attention bit in the CSW was set to 1. 


DOS HARD WAIT 
indicates that the PSW specified in the operand portion of a DOS LPSW 
instruction had its wait bit set to 1 and all interruptions disabled. 
This option will appear automatically only if the service aids routines 
are in storage at the time the condition occurs. 


EMULATOR TRACE REQUESTED 
indicates that the following lines will contain the formatted 
Emulator trace table. 


EQUAL CCMPARE ADDR 111111 STORAGE hhhhhhhh or 
EQUAL COMPARE REG dd STORAGE hhhhhbhh or 
EQUAL COMPARE REG dd CONTAINS REhhhhhbh 
indicates that an equal compare condition has occurred. ADDR 
111111 is the DOS local main-storage address. STORAGE hhhhhhhh 
is the contents of the addressed main storage. 
REG dd is the DOS general purpose register that contains a 
local main-storage address or 
REG dd is the DOS general purpose register that contains the 
data that was compared. 
dd is the register number. | 
CONTAINS hhbhhhhh is the compare data supplied by the user. wi 
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EXTERNAL INTERRUPTION 
indicates that an external interruption was simulated to DOS. 


INPOUT/OUTPUT INTERRUPTION cuu 
indicates that an input/output interruption was simulated to 
DOS. 
cuu is the channel and unit address of the DOS device. 


PROGRAM CHECK 
indicates that a DOS program check interruption occurred. This 
condition includes privileged operations not supported by the 
Emulator, but does not include the supported privileged 
operations. 


PSW = hhhhbhhh thkhhhhh 
indicates that the specified fields of the local execution PSW 
contain the indicated values. 


SNAP DUMP INVORED BY MODULE cccccccc 
indicates that the user exit routine represented by cccccccc 
requested an optional snap dump. 


SUPERVISOR CALL (SVC da) or 

SUPERVISOR CALL (SVC da) MODULE ccecccccc 
indicates that a supervisor call instruction was issued by DOS. 
(sve dad) is the supervisor call instruction. MODULE cccccccc is 
the 8-character B-transient phase or load module name addressed 
by DOS general purpose register 1 at the time of the interruption 
(for svc 2 cr 4 only). 


TIMER INTERRUPTION 
indicates that a timer interruption was simulated to DOS. 


PEPE PELCL CCS C CST SPELT CLS SS CCT CP tet eT ec TCS CS ete Tec eC Tee Te TCC TC CCSCTOCCT TT CCL OCSTOLCC CSCO CSC SST St rT 
*INTERUPT AT 111111 (aaaaaa) 
* 


isi a ADJUSTMENT FACTOR aaaaaa 
1x LIST aaaaaa PSW hhhhhhhh bhhhbhhbhh R14 thhhhhhhh R15 hhhhrhbh AJF aaaaaaaa LMAD 11111111 


OPR aaaaaaaa SVC aaaaaaaa PC aaaaaaaa ASYN aaaaaaaa 
DP raaiaace tienen Senseo stg seitg ee ee 


+ Ht HH tH 


Figure 86 (Part 2 of 7). Service Aids Snap Dump 


INTERRUPT AT 111111 (aaaaaa) 
is the address of the last instruction executed while the CPU was 
in local execution mode. The local address is represented by 111111. 
The adjusted address is represented by aaaaaa. 


DOS ADJUSTMENT FACTOR aaaaaa 
is an address in the Emulator region that corresponds to location 0 
of the adjusted DOS storage area. This value is obtained from the 
adjustment factor field of the local execution list. 


LEX LIST aaaaaa 
is the starting address of the local execution list. 


PSW hhhbhhhh hhhhhhhh 
is the PSW field (first eight bytes) of the local execution list. 


R14 hhhhhhhh 
is the register 14 field of the local execution list. 


R15 hhhhhhhh 
is the register 15 field of the local execution list. 
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AJF aaaaaaaa 
is the adjustment factor field in the local execution list. 


LMAD 11111111 2 
is the limit address field in the local execution list. This 
value corresponds to the DOSSYS parameter in the Emulator execute 
statement. 


OPR aaaaaaaa 
is the true operation pointer field in the local execution list. 
This field points to the last instruction executed while the CPU 
was in the local execution mode. 


SVC aaaaaaaa 
is the Svc interruption address field of the local execution list. 


The value contained in this field should be the entry point address 
of module IIVSVC. 


PC aaaaaaaa 
is the program interruption address field of the local execution 
list. The value contained in this field should be the entry 
point address of module IIVPCE. 


“ASYN aaaaaaaa 


is the asynchronous interruption field of the local execution list. 
The value contained in this field should be the entry point address 
of module TIVRTE. 


HRA RRR IR RK HK KR KK KKK RK KEK AKER EAE KEKE KEE EE EKA ER EEE ERE EKER EEEREREKE KEKE EEEKEEEEKE 
*CSECT TIVCON (EMUCONS) * 
* ADDR DSPL STORAGE * 
* aaaaaa hhhh hhhhhhhh hhhhhhhh hhhhhhbh hbhhhhhh= hhhhhhhh hhhhhhhh hhhhhhhh hhhhhhhb * 
* aaaaaa bhhhh hhhhhhhh hhhhhhhh hhhhhhhh hhhhhhhbh = hhhhhhhh hhhhhhhh hhhhhhhh hhhhhhhh * 
* aaaaaa hhhh hhhhhhhh hhhhhhhh hhhhhhhh hhhhhhhh hhhhhhhh hhhhhhhh hhhhhhhbh hhhhhhhh * 
* LINES aaaaaa TO aaaaaa SAME AS ABOVE * 
* aaaaaa hhhh hhhhhhhh hhhhbhhh hhhhhhbh hhhhhhhh hhbhhhhh hhhhhhhh hhhhhhhh hhhhbhhh * J 
* aaaaaa hhhh hhhhhhhh hhhhhhhh hhhhhhhh hhhhhhhh hhhhhhhh hhhhhhhh hhhbhhhh hhhhhhhh * 
* * 
* * 


LINE aaaaaa SAMF AS ABOVE 
re TS ST STSCI CLCCCS CTC SCCTCCLOCSC SC CS IST LSS SS SS SL SS SSS TTT TTT TS TTT TTS TT CTT TTT TSC TTT ST TS TTT TTT TTT TTS TE TF SF 


Figure 86 (Part 3 of 7). Service Aids Snap Dump 


CSECT IIVCON (EMUCONS) 


identifies the next lines as the contents of the main-storage area 
occupied by the CSECT IIVCON. 


aaaaaa 
is the main-storage address of the line. 


hhhh 
is the displacement from zero of the line. 


LINES aaaaaa TO aaaaaa SAME AS ABOVE 
are the starting addresses of the first and last lines for a group 
of lines that are identical to the line immediately preceding. 


LINE aaaaaa SAME AS ABOVE 


is the starting address of a line that is identical to the line 
immediately preceding. 
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KKK EKER EKER EKAEKEREEEKKEEEE EKER EEKKEKKEE ERE AREER EKHEEKEEKKEEER ERASE KEES EKEKAEEEKAEEKEKKAEEEEEEES 


***EMULATOR I/O CONTROL BLOCKS** 


*SYSLOG COMTAS aaaaaa hhhhhhhh hhhhhhhh hhhhhhhh hhhhhhhh hhhhhhhh hhhhhhhh hbhbbhhh bhhhhhhb 
* hhbhhhhh hhhhhhhh hhhhhhhh bhhbhhhhh hhhkhhhh hhhhhhhh 

* LOGIOB aaaaaa hhhhhhhh hhhhhhhh hhhhhhhh hhhbhbhh hhhhhhhh hhhhhhhh hhhhhbhh hhhhhhhh 
* hhhhhhhh hhhhhhhh 

*cccccccc! COMTAB aaaaaa hhkhbhhh hhhhhhhh hhhbhhhh hhhbhbhhh bhhbhhhh hhhbhhhh hhhbhhhbh 
* hhhhhhhh hhhhhhhh hhhhhhhh hhhhbhhh Ehhhhhhh hhhhhkhh 

* STGCON aaaaaa_ hhhhhkhh hhhhhhhh hhhhhhhh bhhhhbhh hbhhhhhh hhhhhhhh hhhhhhhh 
* bhhhhhhh hhhhhhhh 

*cccccccc} COMTAS” aaaaaa hhhhhhhh hhhhhhhh hhhhhhhh hhhhhhhh hhhhhhhh hhhhhhhh hhhhhhhh 
* hbhhhhhh hhhhhhhh hhhhhhhh hhbhhhhh hhhhhhhh hhhhhhbh 

* IoB aaaaaa hhhhhhbh hhhhhbhhh hhhhhhhh hhhhhhhbh hkhbhhhh hhhhhhbh hhhhhbhh 
* hbhhhhhh hhhhhhhbh 

*cccccccc! CTEXT aaaaaa hhhhhhhh hhhhhhhh hhhhhhhh hhhhhhhh hbhhhhhhh hhhhhhhh hhhhhhbh 
* hhhhhhhh hhhhhhhh hhhhhhhh hhhhhhhh hhhhhhhh hhhhhhhh hhhhhhhh 
*cccecccc2 FIDBLK aaaaaa hhhhhhhh hhhhhhhh hhhkbhhhh hhhhbhhh hhhhhhhh 


ERE EAE KK EE EERE KEKE EEE EEE KEE EKER KEKE EEK EEKEE EKER KKK EKAEEEEEEEEKAKEKEEEREREREKEEERE ERE REKERER EERE EERE SE 


Figure 86 (Part 4 of 7). Service Aids Snap Dump 


**EMULATOR I/O CONTROL BLOCKS** 
identifies the next lines as the contents of the Emulator 
input/output control blocks. The name of each control block precedes 
its address and contents. 


SYSLOG 


identifies the control blocks that follow as being related to the 
DOS system log. 


cccccccci 
identifies the control blocks that follow as being related to the DD 
statement with the ddname cccccccc!, 


cceccccc2 


is the DOS DTF file name associated with the Emulator file identifi- 
cation block. , 


COMTAB 
identifies the control block as an Emulator communications table 
entry. 
LOGIOB 
identifies the control block as the work and constants area for 
Emulator module IIVLOG. 
STGCON 
identifies the control block as the work and constants area for the 
unit record staging modules. 
ITOB 
identifies the control block as an OS input/output block. 
CTEXT 
identifies the ccntrol block as an Emulator COMTAB extension. 
FIDBLK 
identifies the control block as an Emulator file identification 
block. 
aaaaaa 
is the starting address of the control block identified on the same 
line. 


If an invalid FIDBLK chain is detected, the following entry will be 
recorded in the snap dump: 
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* 
* 
* 
* 
* 
* 
* 
* 
* 
* 
* 
* 
* 
* 
* 
* 
* 


***TNVALID FIDELK CHAIN*** 
indicates that the DCB use count in the preceding COMTAB extensior 
entry was greater than the number of file identification blocks 
whose third word pointed back to that COMTAB extension entry. 


REE EE EEE EER EEE EE EEE EEE EE EERE EEE EEE EERE AAA A EEE EERE EEE EERE EEE EEE EEE EEE EEE EEE EE EEE 
*CCW STRING BEGINNING/ENDING BLOCK (RERLK) 


* aaaaaa bbbbbbbb eeeeeeee bbbbbbbb eeeeceee bbbbbbbb eeeeeece bbbbbbbb eeeeeece 
* bbbbbbbb eeeeeeee bbbbbbbb eeeeeeee bbbbbbbb eeeeeeee bbbbbbbb eceeeecee 
* bbbbbbbb eeeeeeee bbbbbbbb eeeeeeee bbbbbbbb eeeeceee bbbbhbbh eeeeeeee 
* bbbbbbbb eeeeeeee bbbbbbbb eeeeeeee bbbbbbbb ereeeeee bbbbbbbb eeeeeeer 
* 

*CCW(S) aaaaaa hhhhbhbhh hhhhhhhh hhhhhhhh hhhhbhhh hhhhhhhh hbhhhhhhh hhhhhhhh hhhhhhhh 
* hhhhhhhh hhhhhhhh bhhhhhhh hhhhhhhh- hhhhhhhh hhhhhhhh 


HERE EKER EE KEE EEE EEE EERE EAEE EEE KEE EEA KEEEREREEKEEEEEEEEE EERE KERR KCEEKKERKEKEREEEKEER KE KEK 


Figure 86 {Part 5 of 7). 
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CCW BEGINNING/ENDING BLOCK {(BEBLR) 
identifies the next lines as the contents of the main-storage area 
occupied by the Emulator control block BEBLK. 

aaaaaa 
is the starting address of the control block. 


bkbbbbbbb 
is the starting main-storage address of a group of CCWs whose 
data addresses were adjusted by the Emulator module IIVCCW. 


eeececee 
is the ending main-storage address of a group of CCWs whose data 
addresses were adjusted by the Emulator module IIVCCW. 


ccw(s) 
identifies the next lines as the contents of the main-storage area 
occupied by a grours of CCWs whose main-storage addresses are found 
in the Emulator contrcel block BEBLK. 


aaaaaa 
is the starting address of the group of CCWs. 


* 
* 
* 
* 
* 
* 
* 
* 


REE EKEKK EE EEE EERE EEE EEE EERE EERE EEEEKEERE REE EKA KEE EKEKE KEKE EERE KEKE EKEKEREREE EERE SE 


*EMULATOR TRACE TABLE STARTING WITH MOST RECENT ENTRY 


hhhhbhhh bhhhhhhh 
OP hh 
hhhhhbbh hhhhhbhh 


* 
* 
* 
* 
x 
* 
* 
* 
* 
* 
* 
* 
* 


x 


RO hhhkhhhh R1 hhhbhhhh* 


*STO cuu SEEK hhhhhhhh hhhhhhhh RPSW hhhhhhhh hhhhhhhh cCAW hhhhhhhh ccwi 

*STO cuu RPSW hhhhhhhh hhhhhhhh CSW hhhhhhhh hhhhhhhh SWS hhhh 
*SIO cuu RPSPW hhhhhhhh hhhhbhhh CSW = hhhhhhhh hhhhhhhh CC#1 

*TIO cuu RPSW hhhhhhhh hhhhhhhh cCSW  hbhhhhhhh hhhhhhhh= SNS hhhh 
*HIO cuu RPSP hhhhhhhh hhhhbhhh cswR hhhhhhhh hhhhhhhh SNS hhbh 
*TCH cuu RPSW hhhhhhhh hhhhhhhh 

*T/O cuu IPSW hhhhhhhh hhhhhhhh CSW hhhhhhhh hhbhhhhh SWS) hhhh 
*ATTN cuu IPSwW hhhhhhhh hhhhhhhh CSW hhhhhhhh hhhhhhhh SWS hhhh 
*ISK TPSW hhhhhhhh hhhhhhhh ADDR 11111111 KEY h 

*SSK IPSW hhhhhhhh hhhhhhhh ADDR 11111111 KEY h 

*SSM IPSW hhhhhhhh hhhhhhhh- RPSW® bhhhhhbhh hhhhhbhh 

* EXT TPSW hhhhhhhbh hhhhhhhh 

*TMR IPSW hhhhhhhh hhhhhhhh 

*LPSW IPSW hhhhhhhh hhhhhhhh RPSW hhhhhhhh hhhhhhhh 

*SV¥C ddd IPSW bhhhhhhh hhhhhhhh RPSW hhhhhhhh hhhhhhhh BTR’ cecccccc 

*S¥C ddd IPSW hhhhhhhh hhhhhhhh LDMD ccecccccce 


**TRACE COMPLETE 


* 


R. bhhhhhhhh R71 hbbhkhhh* 


* 


REE KKH REESE KEKE EEKEKEEEAEEEKEKEKER EEE EEE EH EEK EEEEEEEEKEEEEER AEE AEE EERE 


Figure 86 (Part 6 of 7). 
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EMULATOR TRACE TABLE STARTING WITH MOST RECENT ENTRY 
identifies the next lines as entries in the Emulator trace table. 
The £irst Line printed is the most recent entry. 
line represents an older entry. 
line identifies the tyre of entry on that line: 


° EXT 


514 


Fach succeeding 


The name at the beginning of each 


N input/output interruption entry with the attention 
bit in the CSW set to one 
external interruption entry 
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HIO halt input/output (HIO) entry 
I/O input/output interruption entry 
ISK insert storage key (ISK) entry 
LPSW load PSW {LPSW) entry 

SIO start input/output (SIO) entry 
set storage key {SSK) entry 

SSM set system mask (SSM) entry 

TCH test channel (TCH) entry 

TIO test input/output (TIO) entry 
SVC supervisor call (SVC) interruption entry 
TR timer interruption entry 


e@evewveveee 6 & & 
on 
fa 
a 


ADDR 11111111 
is the local address in main storage. 


BTR cecccccc 
is the name of the B-transient phase when the supervisor call is 
an SVC 2 (DOS fetch). 


CAW hhhhhhhh 
is the DOS channel address word. This value is taken from DOS 
permanent storage location X*4&8* if the device is either staged 
or the DOS system leg. In all other cases, the value is taken 
from location X'24' in the corresponding COMTAB entry. 


CCW1 hhhhhbhh hkhbhhhh 
is the channel command word addressed by the CAW. Refer to 
preceding explanation of CAW for further details. 


cSW bhhbhhhh kbhhhhhh 
is the DOS channel status word. The CSW is taken from location 
X?40' in COS permanent storage. 


cuu 
is the channel and unit for the indicated I/O operation. 


TPSW hhhhhhhh hhhhhhhh 
is the local execution PSW when the interruption occurs. 


KEY h 
is the storage protection key associated with the ISK or SSK instruction. 


LDMD ceccccccc 
is the name of the load module when the supervisor call is an SVC 
4 (DOS load). 


ddd 
is the SVC number. 


OP hh 
is the opcode of the CCW addressed by the CAW. Refer to preceding 
explanation of CAW for further details. 


RPSW hhhhhhbhh hhbhhbhhh 
is the resume PSW. This is the local execution PSW that will be 
used when control is returned to DOS. 


RO hhhhhhhh 
is the contents of DOS general purpose register zero. 


R1 Khhbhhhhh 
is the contents of DOS general purpose register one. 


SEEK hhhhhhbhh khhrhhhh 


is the seek address for direct-access devices. This value is taken 
from the IOR. 
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SNS hhhh 


is the first two sense bytes. 
unit check bit in the CSW is set to one. 


taken from the IO8. 


This field will only appear if the 
The sense bytes are 


EEEEKEK EE EKEEEKEEKKEKEKEEK EKER KEKE EKEEAREKEEEEKEEREREREREEEEEEKKEEEERE 


*DOS RESS 0-7 
* 8-15 


DOS PERMANENT STORAGE 

aaaaaa 111111 hhhhhhhh 
aaaaaa 111111 hhhhhhhh 
aaaaaa 111111 hhhhhhhh 
aaaaaa 111111 hhhhhhhh 
END OF DUMP 


DOS STORAGE 


aaaaaa 111111 hhhhhhhh 
LINFS aaaaaa TO aaaaaa 
aaaaaa 111111 hhhhhhhh 
aaaaaa 111111 hbhhhhhh 


hhhhhhhh hhhhhhhh 
hhhhhhhh hhhhhhhh 
hhhhhhhh hhhhhhhh 
hhhhhhhh hhhhhhhh 


hhhhhhhh hhhhhhhh 
hhhhhhhh hhhhhhhh 
SAMF AS AS3OVE 

hhhhhhhh hhhhhhhh 
hhhhhhhh hhhhhhbh 


LIWE aaaaaa SAME AS ABOVE 


aaaaaa 111111 hhhhhhhh 


* 

* 

*x 

* 

* 

* 

* 

* 

* aaaaaa 111111 hhhhhhhh 
* 

* 

* 

* 

* 

* 

* END OF DUMP 
x 


SHREK EEK EEE KEKKEKEKREEEKREKREKREAKKE EEK KKH EKEKEKKEEKKKEKEKAEEKKE EKA KKEAKEKKEKKEKKEKKE 


Figure 86 (Part 7 of 7). 


DOS REGS 0-7 
8-15 


hhhhhhhh hhhhhhhh 


hhhhhhhh hhhhhhhh hhhhbhhhh hhhhhhkh = hhhhhhhh 
hhhhhhhh hhhhbhhbh hhhhhhhh hhhhhhhh hhhhbhhhh = hhhhhbhh 


hhhhhhhh 
hhhhhhhh 
hhhhhbhh 
hhhhhhhh 


hhhhhkhh 
hhhhhhhh 


hhhhhhhh 
hhhhhhhh 


hhhhhhhh 
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hhhhhhhh 
hhhhhhbh 
hhhhhhhh 
hhhhhbhh 


hhhhhhhh 
hhhhhhhh 


hhhhhhhh 
hhhhhhhh 


hhhhhhhh 


hhhhhhhh 


hhhhhhhh 
hhhhhhhh 
hhhhhbhh 
hhhhhhhh 


hhhhhhhh 
hhhhhhhh 


hhhhhhhh 
hhhhhhhh 


hhhhhhhh 


bhhhhhhh hhhhhhhh hhhhhhhh 
hhhhhhhh 


hhhhhhhh 
hhhhhhhh 
hhhhhhhkh 
hhhhhhhh 


hhhhhhhh 
hhhhhhhh 


hhhhhhhh 
hhhhhhhh 


hhhhhhhh 


identifies the contents of the DOS general purpose registers at 


the time the Emulator service aids routines issued the snap dump. 


PERMANENT STORAGE 


identifies the next four lines as the DOS permanent storage 
assignment (first 128 bytes). 


adaaada 


is the adjusted main-storage address of the line. 


111111 


is the local main-storage address of the line. 


DOS STORAGE 


identifies the next lines as the contents of the main-storage 


area assigned to DOS. 


aaaadada 


is the adjusted main-storage address of the line. 


112111 


is the local main-storage address of the line. 


LINES aaaaaa TO aaaaaa SAME AS ABOVE 
are the starting addresses of the first and last lines for a group 
of lines that are identical to the line immediately preceding. 


LINE aaaaaa SAME AS ABOVE 


is the starting address of a line that is identical to the line 


immediately preceding. 


END OF DUMP 


indicates that the snap dump of DOS main storage is completed. 
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bhhhbhhb 
hhhhhhhbh 
hhhhhhhh 
bhhhhhbh 


hhhhbhhh 
hhhhhhhh 


hhhhhhhh 
hhhhhbhh 


bhhbhhhhh 


* 
* 
* 
* 
* 
* 
* 
* 
* 
* 
x 
* 
* 
* 
x 
* 
* 
* 
* 


EMULATOR GENERAL REGISTER ASSIGNMENTS 


Figure 87 shows the general register assignments for the resident parts of 
the DOS Emulator. 


Register 


0 


1 


15 


Figure 87. 


Symbol 


RPOEU 
RP1TEU 
RWOEU 
RW1TEU 
RW2EU 
RW3ED 
RW&EU 
RWSOEU 
RB1ICD 
RB2CD 
RB3NS 
RB4DS 
RB5DS 
RB6DS 
RLOEU 


RBOCD 


Assignment 


Parameter passing register 


Parameter passing register 


Work 


work 


Work 


Work 


work 


Work 


Base 


register 
register 
register 
register 
register 
register 


register 


1 


2 


5 
6 


2 (used as base for modules) 


Pointer to local execution list 


Pointer to CDOS storage 


Base 
Base 
Base 
Link 


Base 


General Register 


register 
register 
register 
register 


register 


for IIVCON 
6 (DSECT) 
7 (DSECT) 
; 


1 (subroutine) 


Assignments 
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MESSAGE-TO-MOCULE RELATIONSHIP 


Figure 88 shows the relationship between each Emulator message, the module J 
that requests or issues that message, and the module in which the message text 
is contained. 


Message Module requesting Message Module containing 
Number message as Code ___ text 
TIVOOOA TIVLOG == IIVLOG 
IITVOOOTL LIVLOG == IIVLOG 
ITvo002D IIVINT 1,8 IIVMG1 
LITVCO3D TIVINT 2,4 IIVMG1 
ITVOO48D LIVINT 3,8 IIVMG1 
TIVvOOSD LIVINT 4,10 ILVMG1 
ILV006D IIVINT 5,11 TIVMG1 
ITVOO7D TIVINT 6,11 ITTVMG1 
ITVOOBD TIVINT 7,11 LIVMG1 
IIveog.T ITVPUB 22 ITIVMG1 
IITVOi1T TIVINT 13 TIVMG1 
LIVO1V2T TIVIN2 15 TIVMG1 
IIVO1W31 IIVIN2 16 LIVMG1 
IIVOWI TIVGET 123 TIVMG2 
TIVOi5Sr TIVIN2 17 TIVMG1 
IFVO1M7T TIVPUB 23 ITIVMG1 
TIVOt.[ IIVOPN 128 ILIVMG2 
LIVO1W9T IIVINT 14 TIVMG1 
TIVO20T TIVIN2 18 ITIVMG1 
TIVO211 IIVPUB, 24 TIVMG1 
ITVvo227T IIVINT, IIVIN2 19 TIVMG1 
TIVO231 TIVOPN 124 ITVMG2 
ITVO248T TIVOPN 129 ITIVMG2 
IIVO251I LIVINT 25 IIVMG1 
IIVO261I ITIVINT 26 ITIVMG1 
IIVO271I TIVIN2 27 IIVMG1 
IITVO2a1I TIVIN2 28 IIVMG1 
IITV0321I IIVADD 12 TIVMG1 
TIVO331 IIVIN2 20 TIVMG1 
TIVO 348T ITVIN2 21 IIVMG1 
TIVO4sID TIVOPN 125,126 LTIVMG2 
ITvO0aei1.I ITTVOPN 127 LIVMG2 
ITVO50D TIVOEN 130, 131 TIVMG2 
TIVIOOE IIVPUB 101,102,103 LIVMG2 
TIVIOWE LIVPRP 104 IIVMG2 
TIVIO2E ITIVPRP 105 TIVMG2 
LIV1I03E IIVPRP 106 IIVMG2 
IIVIO4UE LIVPRP 107 IIVMG2 
TIViIOSE TIVPRP 108 IIVMG2 
IIVI06E ITVPRP 109 IIVMG2 
IIVIO7E TIVPRP 110 ITIVMG2 
LIVI08E ITIVPRP 172 IIVMG2 
TIVvi09T ITIVPRP 111 IIVMG2 
TIViso.L TIVSTG 119 IIVMG2 
TIV1S01I LIVRTE 120 TIVMG2 
IIVI60A LIVECE, 121 TIVMG2 
LIV2021 ITVABN 113 IIVMG2 
TIV2031 TIVABN 115 TIVMG2 
ITV2040T ITIVAEN 116 IIVMG2 
IIV2051 TIVABN 117 ITVMG2 
IIV2071 ITIVABN 114 TIVMG2 
TIv208.1 IIVGR2 221 IIVMG3 
Figure 88 (Part 1 of 2). Message-to-Module Relationships 
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Message 
Number 


IITVv2501 
IIv2511I 
TIV252T 
ITV2531 
TLTVv254aTt 
TIv2551 
IIv2561I 
TIv2571 
TIV2581 
ITv259I 
IIV2601 
T1IV2611 
IIV2621 
ITIv2631 
ITIV270A 
IIV271A 
TIV273A 
IIV274A 
Tiv2751 
IIV2761 
IIv2801 
ITIV2811 


Figure 88 (Part 2 of 2). 


Module requesting 
message 


IIVGR2 
ITIVGR2 
IIVGR2 
ITIVGR2 
ITIVGR2 
ITIVGR2 
ITVDVS 
IITVDVS 
IITVDVS 
TIVDVS 
TIVDVS 
LIVDVS 
TIVDVS 
TIVPCE 
IIVRCP 
IIVRCP 
ITVRCP 
IIVRCP 
IIVSTG 
ITIVRCP 
ITIVRCW 
LIVRCW 


Module containing 


text 


TIVMG3 
ITIVMG3 
ILTVMG3 
IITVMG3 
IIVMG2 
TIVMG3 
ITIVMG3 
IIVMG3 
IIVMG 3 
IIVMG3 
LIVMG3 
TIVMG3 
TIVMG3 
TIVMG3 
TIVMG3 
ITVMG3 
IIVMG 3 
IITVMG3 
IIVSTG 
ITVRCP 
IITVMG3 
TIVMG3 


Message-to-Module Relationships 
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DOS Compatibility Feature 


Appendix 521 


Page of GY26-3741 
Revised July 25, 1972 
By TNL GN26-8021 


DOS COMPATIBILITY FEATURE 


DOS emulation is assisted by the DOS Compatibility Feature to an extent 
determined by which System/370 model is being used. The execute local 
instruction is provided as a part of this feature. This instruction deals 

with the emulated environment, which consists of the CPU and storage of the 
emulated system (DOS). The instruction is used to achieve the direct execution 
of System/370 nonprivileged instructions and to provide the Emulator with the 
information necessary for such procedures as simulating privileged instructions, 
changing the state of the emulated CPU, and executing the input/output 
operations of the emulated system. 


The emulation of channels and input/output devices is considered to be a 
function of the Emulator. On some models an additional instruction, adjust 

CCW string, is provided to assist in converting channel programs (data addresses 
are modified in the CCWs) in the emulated environment to channel programs within 
the Emulator and vice versa. 


The storage of the emulated system must be embedded within the storage available 
to the Emulator. Addresses relative to the storage of the emulated environment 
are called local addresses; the corresponding addresses relative to the storage 
of the Emulator are called program addresses. The size of the emulated storage 
and the relationship between local and program addresses are provided by the 
operand of the execute local instruction, the local execution list. Other 
parameters of the emulated environment provided by the local execution list are 
the condition code, program mask, local instruction address, and the contents 

of general registers 14 and 15 of the emulated CPU. 


Execution of the execute local instruction causes the CPU to be placed in local 
execution mode. General registers 14 and 15 are loaded from the local execution 
list, and the PSW is modified by replacing the condition code, program mask, 

and the instruction address with values from the list. In local execution 

mode the CPU functions as the CPU of the emulated environment and executes 
nonprivileged instructions contained therein, treating all instruction and 

data addresses as local to that environment. 


Any interruption condition terminates local execution mode. An interruption 
is said to be synchronous if it is a result of instruction execution within 
the emulated environment; if it is caused by conditions or events external 

to the emulated environment it is said to be asynchronous. The current 
parameters of the emulated environment are stored in the local execution list, 
and if the interruption was synchronous, the appropriate interruption code, 
instruction length code, and the program address of the instruction causing 
the interruption are also stored. The instruction address in the PSW is 
replaced by the program address, appropriate to the interruption type, of the 
next instruction of the Emulator. If the interruption was synchronous, 
instruction execution proceeds with the modified PSW. If the interruption 
was asynchronous to local instruction execution, which would be the case, for 
example, with an input/output interruption, the modified PSW is stored in the 
permanent storage location for the interruption type, a new PSW is loaded, 
and instruction sequencing proceeds under control of the new PSW. 


Refer to IBM System/370 Principles of Operation for more information on 
system structure and modes, hardware instructions, input/output operations, 
interruption action, and status switching. 


Execute Local Instruction 


D,(B,) [S] 
B20E B2 | D2 


0 15 16 19 20 31 
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The local execution list (Figure 89), operand of the execute local instruction, 
provides the CPU with the parameters necessary for an emulated environment 
when the CPU is placed in local execution mode. The local execution list is 

40 bytes in length and must begin on a 64-byte boundary. 


Ce 


Bytes O0O-— 3 


Bytes 4— 7 


Bytes 8—11 


Bytes 12 — 15 


Bytes 16 — 19 


Bytes 20 — 23 


Bytes 24 — 27 


Bytes 28 — 31 Supervisor Call Interruption Address 
Bytes 32 — 35 Program Interruption Address 
Bytes 36 — 39 Asynchronous Interruption Address 


Figure 89. Local Execution List 


The condition code, program mask, and instruction address in the current PSW 
are replaced by the values in the corresponding sukfields of the local PSW 
field (bytes 0-7) of the local execution list. General registers 14 and 15 
are loaded, respectively, with the values contained in the general register 
14 and general register 15 fields of the local execution list. The CPU is 
placed in local execution mode. 


The modified PSW is not checked for program interruptions during execution 
of the execute local instruction. The checking occurs as part of the execution 
of the next instruction. 


Any program event exception resulting from completion of the execute local 
instruction is held pending terrination of local execution mode. The program 
event recording code and the program event address, which is either the program 
address of the execute local instruction or the program address of an execute 
instruction, as appropriate, may be stored immediately or when the interruption 
is actually taken. If succ2ssful-branch, storage-alteration, or general- 
register-alteration monitoring is active, the associated program event will 

be indicated, regardless of what bytes of storage or what general registers 
were actually altered by the execute local instruction and regardless of the 
general-register-alteration mask. 


Resulting Condition Code: 
Upon completion of the execute local instruction, the code is set according 


to the condition code loaded from the local PSW field of the local execution 
list. 
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Program Interruptions: 


Operation: The instruction is not installed. The operation is sucpressed. 


Protection: The operand location is protected, and the key in storage 
associated with the operand does not match the protection kev in the PSW. 
The operation is suprressed. 


Addressing: The address of the local execution list is invalid, or the value 
formed by summing the origin address and the local limit address exceeds the 
maximum valid program address if dynamic address translation is not active 

or exceeds 16,777,215 if dynamic address translation is active. The operation 
is suppressed. 


Specification: The operand address does not specify a 64-byte boundary, 
the Origin address is not a multiple of 4996, or the local limit address is 
not one less than a multiple of 4096. The operation is suppressed. 


Segment Translaticn: The address of the lccal executicn list cannot be 
translated. The operation is nullified. 


Page Translation: The address of the lccal execution list cannot ke translated. 
The operation is nullified. 


Translation Specification: A translation specification excention was detected 
while translating the address of the local execution list. The operation is 
suppressed. 


Special Operation: The CPU is already in local execution mode. The operation 
is suppressed. The interruption will he indicated to the program which vlaced 
the CPU in local execution mode. 


Program Event: The execute local instruction has heen nullified or suppressed, 
and attempted execution of the instruction resulted in an instruction-fetching 
event. The program event condition is indicated in the interruption code 
concurrently with the code denoting the exception condition which caused 
nullification or suppression. Successful-branch, storage-alteration, and 
general-register alteration events are not rfossible; they cannot occur with 
the exception conditions causing nullification or suppression. 


Program Event (deferred until local execution mode is terminated): Execution 
of the instruction generated a program-event excepticn. The instruction has 
been completed. 


Local Execution List 


The local executicn list, which is the operand of the execute local instruction, 
provides the CPU with the rarameters necessary for an emulated environment 

when the CPU is placed in local execution mode. Upon termination of local 
execution mode by an interruption condition, the modified values of these 
parameters are stored at locations in the local execution list. Included in 
the list is the address of the first instruction in the Emulator to be executed 
following termination of local execution mode. The following is a detailed 
description of each field and sukfield in the 40-byte list: 


e The Local PSW Field (bytes 0-7) contains the PSW for the emulated 
environment. The PSW is in the BC-mode format. 


The Programming Use Subfield (bits 0-15) is an area in which the 


Emulator may place bits 0-15 of the current BC-mode PSW of the emulated 
environment. This field is neither inspected nor altered by execution 
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of the execute local instruction. The system-mask, protection key, 
machine check mask, BC-mode, wait state, and problem state bits of 
the current PSW are unaltered by execution of the execute local 
instruction. Also unaltered are the following functions: program- 
event recording (although it is inhibited during local execution 
mode), and dynamic address translation for program addresses. 


The Interruption Code Subfield (bits 16-31) is identical to the 
interruption code field in the BC-mode PSW. Upon termination of local 
execution mode by a synchronous interruption, the 16-bit interruption 
code associated with the excepticn ccndition in the emulated 
environment is placed in this field. The contents of this field are 
unpredictable when local execution mode has heen terminated by an 
asynchronous interrurtion. 


The Instruction Length Code Subfield (bits 32-33) is identical to 

the instruction length code field in the BC-mode PSW. When local 
execution mode is terminated by a synchronous interruption, the value 
stored in this field is the same as that stored in the old PSW for 
the same interruption condition in normal mode. The contents of this 
field are unpredictable when local execution mode has been terminated 
by an asynchronous interrurtion. 


The Condition Code Subfield (bits 34-35) replaces the current condition 


code uron completion of the execute local instruction. Upon 
termination of local execution mode because of any interruption 
condition, the current condition code is stored in this field. 


The Program Mask Subfield (bits 36-39) rerclaces the orograr mask in 
the current PSW upon completion of the execute local instruction. 
Upon termination of local execution mode because of any interruption 


condition, the current program mask is stored in this field. 


The Local Instruction Address Subfield (bits 40-63) replaces the 
instruction address in the current PSW upen completion of the execute 
local instruction. It is the local address of the first instruction 
to be executed in local execution mode. Upon termination of local 
execution mode hecause of any interruption condition, the current 
local instruction address is stored in this field. 


The General Register 14 Field (bytes 8-11) provides a fullword value which 
is loaded into general register 14 upon completion of the execute local 
instruction. Upon termination of local execution mode because of any 
interrupticn condition, the current contents of general register 14 are 
stored in this field. 


The General Register 15 Field (bytes 12-15) provides a fullword value which 
is loaded into general register 15 upon completion of the execute local 
instruction. Upon termination of local execution mode because of anv 
interruption condition, the current contents of general register 15 are 
stored in this field. 


The Origin Address Field (bytes 16-19) specifies the program address that 
corresponds to local address 0 for the emulated environment. This address 
must be a multiple of 4096, that is, the three low-order hexadecimal digits 
must be zeros. When this field is fetched from the local execution list, 
the high-order byte is ignored; it is reserved and should be set to 

zero. 


The CPU, in converting a local address to a program address, adds the value 
obtained from this field to the local address. The contents of this field 
are not altered by the execution of the execute local instruction or by the 
local execution mode termination process. 
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e The Local Limit Address Field (bytes 20-23) Specifies the maximum address 
permitted the emulated environment. The address must specify one less 
than a multiple of 4096, that is, the three low-order hexadecimal digits 
must be X'F's. The high-order byte of this field is reserved and should 
be set to zero. The contents of this field are not altered by execution 
of the execute local instruction or by the local execution termination 
process. 


e The Last Instruction Address Field (bytes 24-27) provides, when local 
execution mode is terminated by a synchronous interruption, the program 
address of the instruction causing the interruption. If, however, the 
instruction causing the interruption was the subject of an execute 
instruction, the program address of the execute instruction is stored in 
this field. The high-order byte is set to zero. The contents of this 
field are unpredictable when local execution mode has been terminated by 
an asynchronous interrurtion. 


e The Supervisor Call Interruption Address Field (bytes 28-31) specifies 
the program address of the first instruction to be executed subsequent 
to terminaticn of local execution mode by a supervisor call instruction. 
After the current instruction address has been stored in the local 
instruction address subfield, the contents of the supervisor call 
interruption address field replace the current instruction address in the 
PSW. The high-ordér Eyte of this field is ignored. It is. reserved and 
should be set to zero. The contents of this field are not altered hy 
execution of the execute local instructicn or by the local execution mode 
termination process. 


° The Program Interruption Address Field (bytes 32~«35) specifies the program 
address of the first instruction to be executed subsequent to termination 
of local execution mode by a program interruption condition other than 
one of the address translation exceptions. After the current instruction 
address has been stored in the local instruction address subfield, the 
contents of the program interruption address field replace the current 
instruction address in the PSW. The high-order byte of this field is 
ignored. It is reserved and should be set to zero. The contents of this 
field are not altered by execution of the execute local instruction or 
by the local execution mode termination frocess. 


e The Asynchroncus Interruption Address Field (bytes 36-39) specifies the 
program address of the first instruction to be executed subsequent to 
termination of local execution mode by any asynchronous interruption. 

After the current instruction address has been stored in the local 
instruction address subfield, the contents of the asynchronous interruption 
address field replace the current instruction address in the PSW. The 
high-order byte in this field is ignored. It is reserved and should he 

set to zero. The contents of this field are not altered by execution of 
the execute local instruction or by the local execution mode termination 
process. 


The contents of the local PSW, general register 14, general register 15, and 
last instruction address fields are unpredictable while the CPU is in local 
execution mode. 


Programming Note: Alteration of the local execution list while the CPU is 

in local execution mode gives unpredictable results. For those models which 
check the validity of local addresses, the lccal execution list should be 
placed at a location not addressable while the CPU is in local execution mode. 
For those models which do not, the local execution list should be placed at 
an address that is less than the origin address so as to minimize the chance 
of error. 


Loss of CPU addressability to the local execution list once the CPU has been 


placed in local execution mode will make proper termination of local execution 
mode impossible. The key in storage associated with the local execution list 
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should not be altered while the CPU is in local execution mode. If dynamic 
address translation is active, no translation table entry required for 
translation cf the address of the local execution list should be altered or 
invaliijated while the CPU is in local execution mode. 


Local Execution Mode 


Execution of an execute local instruction places the CPU in local execution 
mode; attached channels are not affected. Program event recording is inhibited 
for subsequent instruction execution while the CPU remains in local ex>rcution 
mode, and any program event exception resulting from execution of the execute 
local instruction remains pending until the CPU is removed from local execution 
mode. The CPU remains in local execution mode until an interrurction or a CPU 
reset occurs. 


In local execution mcde, all instruction and operand addresses are local to 
the emulated environment. Addition of the value contained in the origin address 
field of the local execution list converts these addresses to program addresses. 


Instruction execution in local execution mode proceeds under the protection 
in force at the time the execute local instruction was executed. 


Except as noted below, any installed nonprivileged System/370 instruction may 
be executed while the CPU is in local execution mode. If a privileged 
instruction is encountered, a privileged operation exception is recognized, 
regardless of the problem state bit of the current PSW. If a monitor call 
instruction or any emulation instruction is encountered, a special operation 
exception is recognized. For any of these exceptions, the operation is 
suppressed, and a program interruption takes place. Conditions causing a 
privileged operation exception are checked fcr before conditions that would 
cause a special operaticn excepticn. 


For some models, when a lccal address specifies any part of an instruction 

or data outside the availakle local storage, as defined by the local limit 
address, an addressing exception is recognized. A program interruption takes 
place, and the instruction is suppressed or terminated as appropriate. Such 

an addressing exception has priority over a segment translation or page 
translation exception resulting from attempted translation of the corresponding 
program address. If dynamic address translation is active, an addressing 
exception of lower priority may also be caused by an invalid address in the 
segment or page tables; no distinction is made among the various causes of 
addressing exceptions. 


Alteration of the local execution list while the CPT) is in local execution 
mode gives unpredictable results. 

The condition code and program mask in the current PSW may he altered Ly 
instruction execution while the CPU is in local execution mode. The setting 

of the condition code by instruction execution is unaffected by local execution 
mode. 


The CPU remains in local execution mode when it is placed in the stopped state, 
and, if a program event exception is pending as a result of the execute local 
instruction which placed the CPU in local execution mode, it remains pending. 


Tf the store status function is executed while the CPU is in local execution 
mode, the program address of the lccal execution list is stored in the word 
at absolute storage location 268, and bit 0 of this word is set to one. The 
instruction address in the PSW stored in the doubleword at absolute storage 
location 256 is either the local instruction address or the corresronding 
program address, depending upon the model. (If the execute local instruction 
is installed, execution of the store status function causes all bits of the 
word at absolute storage location 268 to he set to zeros when the CPU is not 
in local execution mode.) 
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Termination of Local Execution Mode 


Any interruption or any reset removes the CPU from local execution mode. J 


Interruptions are divided into two classes: the class of asynchronous 
interruptions which encompasses all those interruptions caused by conditions 
external to the emulated environment, and the class of synchronous interruptions 
which are those resulting from instruction execution while in local execution 
mode. The class of synchronous interruptions is further divided into two 
subclasses: supervisor call interruptions arising from execution of a supervisor 
call instruction while in local execution mode, and program interruptions due 

to exception conditions generated by instruction execution while in local 
execution mode. Program interruptions resulting from segment translation, 

page translation, and translation specification exceptions are asynchronous 
interruptions, since a condition causing such an interruption is external to 

the emulated environment. 


In local execution mode, the recognition of any interruption condition for 

which the CPU is enabled (otker than a pending program event exception resulting 
from the execution of the execute local instruction which placed the CPU in 
local execution mode) causes the current contents of general registers 14 and 
15, the condition code, the program mask, and the instruction address to he 
stored in the corresponding fields of the lccal execution list. If the 
interruption causes nullification, the instruction address is the local address 
of the nullified instruction; otherwise, it is the updated instruction address. 
Additionally, if the interrurtion is a synchronous interruption, the 
interruption code associated with the exception, the instruction length code, 
and the program address of the last executed instruction are stored; otherwise 
the contents of these fields in the local execution list are unpredictable. 

For a program interruption resulting from an odd-numbered instruction address, 
the instruction length code is unpredictable, and the last instruction address 
is the program address corresponding to the odd-numbered local instruction 
address. If the last executed instruction was the subject of an execute ; 
instruction, the frogram address of the execute instruction is stored in the 
last instruction address field. 


After the instruction address has been stored in the local execution list, 

the instruction address in the current PSW is replaced by the supervisor call 
interruption address, the program interrurtion address, or the asynchronous 
interruption address from the local execution list, as appropriate. The 
modified PSW is not checked for program interruptions during the process of 
termination of local execution mode; these checks occur as part of the execution 
of the next instruction. 


The CPU is then removed from local executicn mode, and if the interruption 
was a synchronous interrurtion, the interruption condition is cleared. If 

a program event excepticn is pending as a result of the execute local 
instruction that placed the CPU in local execution mode, the exception is now 
recognized. 


T£ the interruption was a synchronous interruption, and if no program event 
exception is recognized, instruction execution froceeds as specified by the 
modified PSW. If the interruption was an asynchronous interruption, or if 

a program event exception has been recognized, the modified PSW, with any 
ancillary information, is stored in the permanent storage locations for the 
highest priority interruption condition pending, a new PSW is loaded from the 
appropriate permanent storage location, and the highest priority interruption 
condition is cleared. The state of the CPU and subsequent instruction execution 
are as specified by this new PSW, which alsc specifies whether any interruption 
conditions of lower priority are accepted or kept pending. 
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If the CPU was removed frem local execution mode because of a segment 
translation, a page translation, or a translation specification exception, 
and if a program event exception is recognized when local execution mode is 
terminated, both conditions are indicated concurrently in the program 
interruption code stored. 


An indication of an enabled input/outfut or external interruption condition 
may cause the CPU to initiate terrination of local execution mode. In such 

a case, should a pending program event exception be recognized, it is 
permissible for the CPU tc complete termination of local execution mode and 
subsequently take the program interruption, even though the indication of the 
initial interrurpticn condition ke canceled. 


Under certain ncnrecoverable machine check conditions, the CPJ may be unakle 

to store into the local execution list or to fetch the asynchronous interruption 
address from the list. In such cases, local execution mode is terminated, 

any pending program event exception is lost, and the contents of the local 
execution list are unpredictable, as is the instruction address in the machine 
check old PSW. 


Otherwise, if upon termination of local execution mode the CPJ is unable to 
store into the local execution list or to fetch the appropriate interruption 
address from the list, a protection exception is recognized, regardless of 
the reason why the list cannot ke accessed. Any supervisor or program 
interruption conditions resulting from instruction execution in local execution 
mode are cleared. A program event exception pending from execution of the 
execute local instruction may be lost or may be indicated concurrently with 
the protection exception. Local execution mode is terminated. The contents 
of the local execution list and the instruction address in the old PSW are 
unpredictable. On some models, if the CPU is unable to access the local 
execution list upon termination of local execution mode, the CPU will enter 
an internal loop trying to terminate local execution mode; in these cases, 
the CPU must be reset. 


Any reset of the CPU in local executicn mode results in termination of local 
execution mode. Execution of the current CPU operaticn is terminated, and 

all pending program and supervisor call interruption conditicns are cleared. 
The contents of the local execution list are unpredictable. After a CPU reset 
while in local execution mode, the instruction address in the old PSW is either 
the local instruction address or the correspcending program address if the reset 
occurred while the CPU was in the stopped state; otherwise, it is unpredictable. 
After any other reset the PSW is cleared to zeros. 


Programming Notes: When any address translation exception occurs while the 
CPU is in local execution mode, the instruction address in the program old 
PSW resulting from the interruption is the asynchronous interruption address 
from the local execution list, not the program address of the instruction 
causing the interruption. 


Instruction execution in local execution mode may alter the program mask. 
After termination cf local execution mode, the program mask in the current 
PSW is the same as that which has been stored in the local execution list. 


Model Dependencies: The System/370 Model 155 does not check local addresses 
against the local limit address unless the dynamic address translation facility 
is installed. 


The System/370 Model 155 stores a PSW containing the frogram address 
corresponding to the local instruction address when the store status function 
is executed while the CPV is in local execution mode. On all other models, 
the instruction address in the PSW stored is the local instruction address. 


After a CPU reset while in the stopped state, the instruction address in the 
PSW is the program address corresponding to the local instruction address in 
the System/370 Model 155. On all other models, the instruction address is 
the local instruction address. 
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The System/370 Model 155 is unable to recover when it finds itself unable to 
access the local execution list upon termination of local execution mode. 


Adjust CCW String Instruction 


Dz (B.) [Ss] 
B20F B2 | D2 


0 15 16 19 20 


As part of the COS Emulaticn Feature, an instruction, called the adjust CCW 
string instruction, is provided on some CPU models to assist the Emulator in 
locating the CCWs of a channel frogram, testing the validity of the addresses 
of CCWs and their storage areas, and adjusting their data addresses. On other 
models, these functions are accomplished by the Emulator. 


Consecutive doublewords are interpreted as a string of CCWs, and the data address 
fields of these CCWs are adjusted by the addition of a signed adjustment factor. 
The string of CCWs begins at a location designated in the CCW address field 

of a list specified by the operand address. The list, called the ACCW list, begins 
on a 64-byte boundary and contains these fields: 


Bytes O-— 3 Signed Adjustment Factor 
Bytes 4-— 7 Local Limit Address 
Bytes 8— 11 Operation Byte 

Bytes 12 — 15 Operation Pointer 
Bytes 16 — 19 CCW Address 


Bytes 20 — 23 TIC Data Address 


Figure 90. ACCW List 


The signed adjustment factor used to adjust the data address field is contained 
in the ACCW list. The factor is a nonnegative value to convert addresses local 
to the emulated environment to program addresses, and it is a negative values 

to convert program addresses to local addresses. Adjustment consists in 
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replacing the data address in a CCW with the 24 low<order bits of the algetraic 
sum of the adjustment factor and the data address, where the latter is 
considered to be an unsigned binary number. The data address fields of 
consecutive CCWs are adjusted until one of the following conditicns occurs: 


° The last CCW of the string, as indicated ky the absence of both the chain 
data and chain command flags, has been adjusted. 


® A CCW whose command code specifies transfer in channel has been adjusted. 
e A CCW specifying indirect data addressing has keen adjusted. 


e A CCW has been adjusted that specifies a local storage area at least 
partially outside the limits of local address 0 and the local limit address. 


e The local address of the next CCW to be adjusted falls outside the area 
bounded by local address 0 and the local limit address, or the local address 
does not specify a doubleword boundary. 


Anyone of these conditions completes execution of the adjust CCW string 
instruction and sets the condition code to indicate the reason for completion. 
The program address + 8 of the last CCW adjusted is placed in the ACCW list. 
If data chaining was in progress, the command code and the program address 

of the CCW containing the command code are stored in the operation byte field 
and the operation pointer field, respectively, of the ACCW list. Otherwise, 
zeros are stored in the operation byte field. If the last CCW adjusted 
specifies transfer in channel, the TIC data address field of the ACCW list 
contains the data address, prior to adjustment, that was in the CCW. 


Execution of the instructicn may be interrupted by an external event. If an 
interruption condition is presented to the CPU during execution of the 
instruction, with the CPU enabled for the interruption, the interruption is 
taken upon ccmpletion of the current unit of operation. A unit of operation 
is the operation within the instruction execution required for complete 
adjustment of a CCW. The instruction address stored in the old PSW as a result 
of the interruption is the address of the adjust CCW string instruction, or 
the address of an execute instruction if the adjust CCW string was the object 
of such an instruction. The contents of the ILC and cc fields in the old PSW 
are unpredictakle. The contents cf the ACCW list are such that execution of 
the adjust CCW instruction may be resumed -ty loading the old PSW stored as 

a result of the interruption. 


Resulting Condition Code: 


©) End of the CCW string; the last CCW adjusted specifies neither data 
chaining nor command chaining. 

1 A CCW specifying transfer in channel was the last CCW adjusted. 

2 The last CCW adjusted specifies a local storage area at least partially 


outside the limits of local address 0 and the local limit address. 


3 The local address of the next CCW to be adjusted does not specify 
a doukleword boundary or is outside the limits cf local address 0 
and the local limit address, or the last CCW adjusted specifies 
indirect data addressing. 
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Program Interruptions: 


| 
Operations: The instruction is not installed. The operation is suppressed. J 


Protection: The operand location is protected, and the key in storage 

does not match the protection key. The operation is suppressed for fetching 
and terminated for storing; or a CCW in the designated string is protected, 
and the operaticn is terminated. 


Addressing: The address of the ACCW list is invalid, and the operation is 
suppressed; or the address of a CCW in the designated string is invalid, and 
the operation is terminated. 


Specification: The operand address does not specify a 64-byte boundary, 
or the signed adjustment factor is not a multiple of 4096, or the local limit 
address is not one less than a multiple of 4096. The operation is suppressed. 


Segment Translation: The address of the ACCW list or of a CCW cannot be 
translated. The operation is nullified. 


Page Translation: The address of the ACCW list or of a CCW cannot he 
translated. The operation is nullified. 


TranSlution Exception: A translation specification exception is detected while 
translating the first operand address or the address of a CCW. The operation 
is terminated. 


Special Operation: The adjust CCW string instruction was encountered while 

the CPU was in local executicn mode. The operation is suppressed, and the 
interruption is indicated to the program that placed the CPU in local execution 
mode. 


Program Event: An instruction-fetching or storage alteration event has been J 
encountered. The operation is completed, nullified, or terminated. (See the 
detailed descrirticn cf program-event reccrding.) 


The ACCW List 


The operand of the adjust CCW string instruction is the ACCW list. The 
following is a detailed déescription of each field in the 24-byte list at the 
initiation of the instruction execution: 


The Signed Adjustment Factor Field (bvtes 0-3) is a signed fullword binary 
number whose value must be a multiple of 40996 (that is, the three low-crder 
hexadecimal digits must be zeros). 


The Local Limit Address Field (bytes 4-7) provides the maximum address permitted 
the emulated environment. This address must be one less than a multiple of 

4096 (that is, the three lcw-order hexadecimal digits must be X'FFF'). Local 
CCW addresses and the extreme lccal addresses of the storage area defined for 
each CCW by the data address, command code, and count must fall between local 
address 0 and the local limit address. The high-order byte of this field is 


reserved, and should be set to zero. 


The Operation Byte Field (bytes 8-11) when zero, byte 11 indicates that the 
initial CCW to be adjusted contains its own cormand code. When tyte 11 is 

not zero, the first CCW to be adjusted is considered to be part of a sequence 
of ccWs that are data chained together, and byte 11 provides the cormand code 
for this sequence. When fetched from the ACCW list, the three high-order bytes 
of this field are ignored; they should be set to zeros. 


2 
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The Operation Pointer Field (bytes 12-15) contains the address of the CCW that 
originated the operation byte for the last CCW adjusted that did not specify 
transfer in channel. When the field is fetched from the ACCW list the high- 


order byte is ignored; it is reserved and should be set to zeros. 


The CCW Address Field (bytes 16-19) provides the address of the first CCW to 
be adjusted. When this field is fetched from the ACCW list, the high-order 
byte is ignored; it is reserved and should be set to zeros. 


The TIC Data Address Field (bytes 20-23) is ignored upon initiation of 
instruction execution. 


The contents of the signed adjustment factor field and the local limit address 
field are not altered by the adjust CCW string instruction. At the end of 

the operation the contents of the remaining fields depend upon the manner in 
which execution tock place. In general, if the operation was suppressed, the 
contents of the entire list are unaltered, while if the operation was 
terminated, the contents of bytes 8-23 of the ACCW list are unpredictable. 
Upon instruction nullification or completicn, the contents of the remaining 
fields are as follows: 


e For the operation byte field: 
— Bytes 8-10 will always be zeros. 
- Uron corpletion with condition code 0, bute 11 will be zero. 


— Upon completion with condition code 1, if the TIC command was data 
chained into, byte 11 will contain the command code in force for the 
string of CCWs data chained together; otherwise, it will Le zero. 


- Upon completion with condition code 2, byte 11 will contain the command 
code in force for the last CCW adjusted if that CCW specifies data 
chaining; otherwise, it will be zero. 


— Upon completion with condition code 3: 
If no CCWs have been adjusted, byte 11 is unaltered. 


If the last CCW adjusted specifies indirect data addressing, byte 
11 will contain the command code in force for that CCW. 


If the last CCW adjusted does not specify indirect data addressing, 
byte 11 will contain the command code in force for the last CCW 
adjusted if that CCW specifies data chaining; otherwise it will be 
zero. 


Upon nullification, if the last CCW adjusted specifies data chaining, 
byte 11 will contain the command ccde in force for that CCW; otherwise, 
it will ke zero. 


e For the operation pointer field: 
— The high-order byte will be set to zero. 


— UWeon completicn with condition code 1, if the TIC command was data 
chained into, the operation pointer field will contain the program 
address of the ccW at the start of the chain of CCWs data chained 
together. Otherwise, the operation pointer field will contain the 
program address of the CCW containing the command code in force prior 
to fetching the TIC command. 
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_ Upon completion with condition code 3, when no CCWs have keen adjusted, 
the operation pointer field will contain the same address as upon 
initiation of instruction execution. 


- Under all other conditions, the operation pointer field will contain 
the program address of the CCW containing the command code in force 
for the last CCW adjusted. 


e For the CCW address field: 
— The high-order byte will ke set to zero. 


_ Upon completion with ccndition ccde 3, when no CCWs have been adjusted, 
the CCW address field will contain the same address as upon initiation 
of instruction execution. 


— Under all other conditions, the CCW address field will contain the 
program address + 8 of the last CCW adjusted. 


® The TIC data address field: 


_ Upon completion with condition code 1, the TIC data address field 
contains zero in byte 20 and the data address from the TIC command, 
prior to its adjustment, in bytes 21-23. 


— Under all other conditions, the TIC data address field is unaltered 
by execution of the adjust CCW string instruction. 


Upon nullification due to a segment-translation exception or a page translation 
exception encountered when attempting to access the initial CCW, the data 
contents of the ACCW list are unaltered. The high-order byte of the operation 
pointer field and the CCW address field and bytes 8-10 of the operation byte 
field may either be unaltered or set to zeros. 


Programming Note: 


If a CCW specifies transfer in channel, no limit checking of the data address 
occurs. The data address is adjusted, and the instruction is completed with 
condition code 1. 


If a CCW specifies indirect data addressing, no limit checking of the data 
address occurs. The data address is adjusted, and the instruction is completed 
with conditicn code 3. 


During execution of the adjust CCW string instruction, the contents of the 
ACCW list are unpredictable. In particular, the CFU may alter the contents 
of the list after the adjustment of each CCW in the string. 


Tf the CPU is unable to access the ACCW list after initiation of the adjust 
ccW string instruction, the operation will ke terminated. The cause of 
termination will be indicated as a program interrurtion due to protection 
exception. 


This condition may arise independently of any other interruption conditions, 
or it may be detected only when an attempt is made to store into the ACCW list 
in order to interrupt the adjust CCW string instruction. In the latter case, 
the program interruption due to protection exception is taken (concurrently 


with a program event exception if necessary). Any address translation 


exceptions are lost. If the interruption ccndition is of lower priority than 
the program interruption, the program interruption occurs first, and the other 
interruption is subject to the control of the mask bits in the program new 
PSW. 


Model Dependencies: 


The adjust CCW string instruction is available on Models 145 and 155. 
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GLOSSARY 


The terms in this glossary are defined as they pertain to this document. 
ACCW list: See adjust CCW list. 


address translation: The process of changing the address of a data item or 
an instructicn from its virtual address to its real storage address. 


adjust CCW list: The area of main storage that contains data pertinent to 
the adjust CCW string instruction (See Aprendix). 


adjust CCW string: The instruction used to modify CCW command addresses so 
they address the main-storage area assigned to the DOS storage area in the 
Emulator region. 


adjustment factor: A constant that is added to the address fields of DOS 
instructions as they are executed. 


appendages: Emulator routines that provide additional control over I/0 
operations during channel program execution. An appendage may receive control 
when a channel end, abnormal end, end-of-extent, or a start I/O condition 
occurs. Refer to Data Management for System Programmers for OS or OS/VS. 


asynchronous interruptions: Interruptions that occur without regular time 
relationships; unexpected or unpredictable with respect to the execution of 
a program's instructions (1/0, machine check, external). 


background partition (BG): In DOS, storage is divided into three partitions. 
The partition with the lowest priority is the background partition (see 
"foreground partition'). 


basic telecormunications access method (BTAM): Contrcels transmission and 
reception of messages over telecommunications lines in response to READ, WRITE 
and CONTROL macro instructions issued in the user's problem program. The 
primary functions of BTAM are channel program generation at object time and, 
at the user's ortion, buffer management. 


beginning and end block (BFELK): Contains one 8-byte entry for each group 
of ccWs that contain the beginning and ending addresses +8 of each group. 


bootstrap: A technique or device designed to bring a program into main storage 
by means of its cwn action, for example, a subroutine whose first few 
instructions are sufficient to bring the rest of it into the computer from 

an input device. 


B-transient area: A special area of the DOS supervisor reserved for B-transient 
routines. 


B-transient routines: DOS routines that deal primarily with the logical 
input/output control system. These routines are located in the core image 
library. 


channel address word (CAW): Contains the address of the first CCW. 

channel command word (CCW): Indicates to a channel what I/0 operation it 
should start. For operations involving data transfer, also indicates the main- 
storage location into which data is to be placed or read from, and how many 
bytes of data are to ke transferred. 


channel status word (CSW): Indicates to a program the status of an I/0 device, 
control unit, channel, and subchannel. 
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command control block (CCB): A DOS control block containing information 
pertinent to DOS data set processing. 


| 
common area: A control section used to reserve a main-storage area that can J 
be referred to by other modules. communications table (CCMTARB): Contains 


one entry for every DOS device allocated to emulation plus an entry for SYSLOG. 


compatible data set: When a data set does not have to be changed in format 
to ke accessed by the Emulator, DOS, or OS. 


COMTAB extension: The control block that is either chained to a COMTAB entry 
or to another COMTAB extension entry. There is one COMTAB extension entry 
for every shared or OS indexed sequential data set. 


conversion: The process of changing from one form of representation to another, 
for example, converting indexed sequential data sets from DOS to OS format. 


DASD label (DLBL): Internal format of a DOS DLBL extent statement read from 
the label cylinder by DOS OPEN phases. 


data control blceck (CCB): A control Flock through which the infcrmation 
required by access routines tc store and retrieve data is communicated to the 
access routines. 


data_definition (DD) statement: A job control statement that describes a data 
set associated with a particular job step. 


data_event_control block (LDECB) -- BISAM: A control block through which 
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information concerning input or output operations is communicated to BISAM. 


data _ extent block (DEB): Contains one or more extent entries and other control 
information for the data set with which it is associated. 


data set: The major unit of data storage and retrieval in the operating svstem, ) 
consisting of a collection of data in one of several prescribed arrangements 

and described by control information to which the system has access. See also 

file. 


data_ set control block--extension (format 3) (DSCB): A control block that 
describes up to 13 additional extents that cannot be described in a format 
1 DSCB. 
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data_set control block--identifier (format 1) (DSCB): A control block that 
describes the characteristics and up to three extents cf a data set. 


data _set control block--VTOC (format 4) (CSCB): The 140-byte block, always 
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the first DSCB in the VTOC, that describes the VTOC data set. 


data set name: A 44 character name that identifies an OS data set. This name 
must be identical to the DOS file ID to indicate a DOS shared file. (See also 
DSNAME and file ID.) 


dedicated device: A device assigned specifically to operate under DOS. Tt 
is inaccessible to OS programs until released from this assignment. 


define the file (DTF): A macro instruction that describes the characteristics 
of a logical file, indicates the type of processing for the file, and specifies 
the main-storage areas and routines to be used. 


define the file for indexed sequential (DTFIS): Same as the definition for 


a DTF except that a DTFIS describes the characteristics of a logical file for 
TSAM. 
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DIAG block: The area of main storage used to adjust and readjust the data 
address portions of the cCCWs from DOS local addresses to OS true addresses, 
then back to DOS local addresses. 


diagnostic block: See DIAG block. 


direct-access storage device (DASL): A type of storage device wherein access 
to the next position from which informaticn is to be obtained is in no way 
dependent on the position from which information was previously okftained. 


disk operating system (DOS): Wherever the term DOS is used in this manual, 
it refers to DOS system and/or DOS problem rfrograms. 


DLBL/EXTENT card imag : Contains the extent limits, extent type, extent 
sequence number, logical unit, vclume serial number, expiration and creation 
dates, and DLBL indicator according to the OS information about the file. 


DOS compatibility feature: A hardware feature that permits execution of DOS 
programs within the OS environment. 


DSNAME: A parameter ina DD statement that is used by the operating system 
to locate the data set on a volume. (See also data set name.) 


DTFIS ADD-RETRVE-APDRTR table: A DTF table built at assembly time and tailored 
to the DTF parameters associated with the add and retrieve functions of ISAM. 


DTFIS load table: A DTF table built at assembly time and tailored to the DTF 
parameters associated with the load function of ISAM. 


dummy record: A record that takes up space ina file but is not actually a 
record of that file. 


dynamic address translation (DAT): A hardware feature that performs the 
translation of a virtual storage address to a real storage address during 
execution of an instruction. 


ECB pointer table: A list of 4-byte addresses for SYSLOG, the three Emulator 
ECBs (prompt, WTOR, and timer), and the ECBs for staged devices and devices 
being used for emulation. 


EMUCONS: A dummy section (DSECT) containing data constants common to most 
Emulator modules. See also IIVCON. 


emulation: The combination of programming techniques and special machine 
features that permits DOS programs to operate in the OS environment. 


Emulator (as used in this publication): Designates the DOS Emulator program 


IIVEMJ. See also emulation. 


Emulator region: The main-storage area (OS) in which the Emulator program, 
Emulator control tlocks, and the DOS main-storage area reside. 


event control block (ECB): A control block used to represent the status of 
an event. 


execute: To carry out an instruction or perform a routine. 
execute local: The instruction used to place the system in local execution 
mode and to adjust the instructions and instruction operands within the storage 


area assigned to the adjusted DOS storage area. 


extent: The physical locations on input/output devices occupied by, or reserved 
for, a particular data set. 


FCB: See forms-ccntrol buffer. 
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FCB image: An image of the carriage control used by the IBM 3211 Printer and 
the Emulator. The image must be assembled and link-edited into SYS1.IMAGELIB. 
(See forms-ccntrol buffer.) 


file: The major unit of data storage and retrieval in the disk operating 
system, consisting of a collection of data in one of several prescribed 
arrangements and descriked by control information to which the system has 
access. See also data set. 


file ID block (FICBLK): A block for each opened file to map a DCS OPEN DTF 
+o an OS OPEN [C3. 


foreground partition: In DOS, storage is divided into three partitions. The 
partitions with highest and next-to-highest priority are foreground partitions. 


forms-ccntrol buffer: The forms-control buffer (FCB) is 180 positions and 

is used to store vertical formatting information. Each position corresponds 
to a line on the form. The FCB is addressed in synchronism with carriage 
movement. Channel codes used for skipping control are stored at the FCB 
addresses corresronding to the desired line positions on the form. A flag 

bit off or on at FCB address 1 determines six or eight lines per inch vertical 
spacing resvectively. The flag bit on at an address other than 1 identifies 
the corresponding line as the last line on the form. The FCB is loaded by 
the "load FCB" command. 


forms-control image: A term applied to the Emulator. (See FCB image.) 


hard wait: A condition in which the system is placed in the wait state with 
all interruptions disabled. 


TIVCON: A control section containing data constants common to most Emulator 
modules. See also EMUCONS. 


IIVRCN: A control section cintaining data contents common to the service aids 
modules. See also RASCONS. 


image: See FCE image. 


initial program load (IPL): The initialization procedure that loads the nucleus 
or supervisor and begins normal operation. 


input/output block (TOB): A block used for communication between the proklem 
program and the system; provides the addresses of the other control blocks 
and maintains information about the channel program, such as the type of 
chaining and the progress of I/O operations. 


integrated Emulator: An Emulator designed to be executed under control of 
a system control program in a multiprogramming environment. 


interface: A shared boundary, such as OS and DOS control blocks that are 
modified or examined by the Emulator. 


ISAM block (ISBLK): A taktle built by the Emulator when a DTFIS is opened and 
used at I/O macro time to map to the OS data set. 


ISK/SSK table: Contains one 1-byte entry for each 2K block of DOS dynamic 
storage. 


job file control block (JFCB): A control kElock holding the internal format 
of an OS DD statement. 


job (JOB) statement: The control statement that identifies the beginning of 
a series of job ccntrol statements for a single job. 
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library: A collection of related files (DOS) or data sets (0S). 


load modules: Reside on a link or job library for the purpose of being loaded 
into main storage. 


local address: An unadjusted DOS main-storage address. 


local execution list: The area of main storage that contains data that is 
pertinent to the execute local instruction (see Appendix). 


local execution mode: That state the CPU enters when the execute local 
instruction is issued (see Appendix). 


local execution PSW: Effective DOS current PSW when CPU is in local execution 
mode. 


logical unit block (LUB): A DOS control block that associates a COS logical 
unit with its corresponding physical unit. 


map: Ao establish a correspondence between the elements of one set and the 
elements of another set, such as to assign to every DOS device a device of 
the same type or a DOS macro to an OS macro. 


module: An entity associated with a single assembly cr compilation. The 
smallest unit used for distributicn and maintenance purposes, for example, 

the set of statements in some source language that is compiled, or the resulting 
code. 


normal mode: That state of the CPU during execution of OS or Erulator programs. 


Open table: A common section located in the B-transient area for all DOS 
OPEN/CLOSE phases initialized by phase 1 of the OPEN or CLOSE monitor. 


OS PUB table: Contains a 1-byte entry for each DOS PUB that functions as an 
index into COMTAB. 


page table: A table that indicates whether a page is in real storage and 
correlates virtual addresses with real storage addresses. 


page translation exception: A program interruption that occurs when a virtual 
address cannot be translated by the hardware because the invalid bit in the 
page table entry for that address is set. 


partition: See region. 


password data set: An OS data set that is protected from other users by means 
of a password that must be given to the operating system at the time the data 
set 1s accessed. 


phase: Under DOS, the smallest ccmplete unit that can be referred to in the 
core image library. Each overlay of a program or the program itself, if it 
contains no overlays, is a single, complete phase. 


physical unit block (PUB): A DOS ccntrol block that contains information 
pertinent to the device characteristics of an input/output unit. 


post ECB list: Contains one 2-byte entry for each entry in COMTAB, the first 
of which is an index into COMTAB and the second the completion code from the 
ECB when it was last posted. 


preformatted COS file: The capacity records are reset to reflect empty tracks 


on the file of a disk pack or data cell. This is done in preparaticn for 
creating a new file. 
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private volume: In OS, a mounted volume that the system can allocate to an 
output data set only when a specific volume request is made. A private volume 
is demounted after its last use in a job stefp. ) 


privileged instruction: An instruction that can only be executed when the 
CPU is in supervisor state. 


problem program: Any program that is not part of the Operating System: a 
routine that solves problems, sorts and merges records, performs computations, 
etc., aS opposed to a contrcl program or a language translator. 


processing program: A general term for any program that is not a control 
program. 


program event recording (PFR): A hardware feature used to assist in debugging 
programs by detecting program events. 


program information block (PIB): A DOS centrol block that contains information 
pertinent to DOS task management. 


program status word (PSW): A doubleword in main storage used to control the 
order in which instructions are executed and to hold and indicate the status 
of the system in relaticn to a particular program. 


prompt: A special Emulator message that allows the operator to communicate 
with the Emulator at any tire. 


protection key: An indicator, associated with a task, that appears in the 
program status word whenever the task is in control, and that must match the 
storage keys of all storage blocks it is to use. 


public volume: In OS, a mcunted volume that the system can allocate to an 
output data set for which a ncecnspecific vclume request is made. A public 

volume remains mounted until the device on which it is mounted is required 
by another volume. 


RASCONS: A dummy section (DSECT) containing data contents common to the service 
aids modules. 


reader/interpreter: The part of the control program that controls the reading, 
transcription, and interpretation of an input job stream. 


region: An area Of main storage set aside for a job. 


resident volume (COSRES): The direct~-access volume in which the DOS IPL program 
and supervisor reside. ; 


resume PSW: The PSW DOS continues with whether or not modified by the Emulator, 
i.e., the local execution PSW. 


root segment: That segment of an overlay program that remains in main storage 
at all times during the execution of the overlay program; the first segment 
in an overlay program. 


routine: An ordered set cf instructions that may have some general or frequent 
use. A module may consist of one or several routines. 


seqment table (SGT): A table used in dynamic address translation to control 
user access tc virtual storage segments. Each entry indicates the length, 
location, and availability of a corresponding page table. 


seqment table entry (STF): An entry in the segment table that indicates the 
length, location, and availability of a corresponding page table. 
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segment translation exception: A program interruption that occurs when a 
virtual address cannot be translated by the hardware because the invalid bit 
in the segment table entry for that address is set. 


shared data set: When other OS job steps may access a data set concurrently 
with the Emulator. 


shared volume: When other OS jok steps may access a volume concurrently with 
the Emulator. 


Simulation (as used in this puklication): The programming techniques used 
in the Emulator to produce, as nearly as possible, the results that DOS 
instructions and hardware functions produce in a stand-alone DOS environment. 


Snap dump (as used in this publication): A selective dynamic formatted dump 
performed at various points in a program run. 


soft wait: That state the CPU enters when the wait bit of the current PSW 
is set to one and interruptions are enabled. 


spooling: All primary input streams are read from an input device and 
temporarily stored on a DASD in a format convenient for later processing by 
the Operating System and user programs. System and selected user print and 
punch output are similarly stored on a DASD until a convenient time for writing 
hard copy. 


staged I/0: The ability to request input/output operations without regard 
to the characteristics of the input/output devices; partitions compete for 
these devices on a priority basis or on a first-in, first-out determinant. 


staged I/O constants block (STGCON): The block residing in the IOB area for 
staged devices that contains data unique to the particular device being staged. 


stand-alone DOS: The disk operating system as it functions in its own 
environment (contrasted to DOS when it is emulated). 


Stand-alone emulator: An Emulator that can he executed only on a computing 
system totally dedicated to that frogranm. 


Subroutine: A routine that can be part of another routine. 


supervisor: The medium through which the use of resources is coordinated and 
the flow cf operations through the CPU is maintained; hence, a control program 
that executes in the supervisor state. 


supervisor call (SVC): An instruction that causes an SVC interrurption in the 
hardware to give control to a Ccntrcl program routine {called an SVC routine) 
for some Specific action, such as reassigning parts of main storage or 
retrieving data from an I/O device, This interruption mechanism differs when 
the program is running in lccal execution mode. See the Appendix for details. 


synchronous interruptions: Interruptions that occur with a regular or 
predictable time relationship (program check, SWC). 


SYS1.IMAGELIB: The OS system library in which UCS and FCB images reside. 


SYS1.LINKLIB: The OS system library that contains executable programs and 
modules. 


tape error block (TEB): A DOS control block that contains information pertinent 
to error recovery processing. 


tape error block by volume (TEBV): This is a DOS table composed of one status 


block and (n) error blocks and pointed to by the TFEVTAB field in the DOS BG 
COMREG extension. 
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task: A unit of work for the central processing unit from the standpoint of 
the control program, that is, the basic multiprogramming unit under the control 
program. 


task I/O table (TIOT): A table that contains information pertinent to input 
and output processing. One TIOT entry is created by the Operating System for 
each DD statement supplied in the job step. 


translation specification exception: A program interruption that occurs when 
a page table entry, segment table entry, or the control register pointing to 
the segment table contains infcrmation in an invalid format. 


trap (as_ used in this publication): Intercepting a given DOS event and 
recognizing certain specific DOS or Emulator conditions. 


true address: An actual main-storage address (OS) within the Emulator region. 


unit control block (UCB): An OS control Elock that contains information 
pertinent to the device characteristics of an input/output unit. 


Virtual storage: Addressable space that appears to the user as real storage, 
from which instructions and data are mapped into real storage locations. The 
size of virtual storage is limited by the addressing scheme of the computing 
system and by the amount of auxiliary storage available, rather than by the 
actual number of real storage locations. 


volume: That portion of a single unit of storage media that is accessible 
to a single read/write mechanism, for example, a drum or disk pack, ora 
recording medium that is mounted and demounted as a unit, for example, a data 
cell. 


volume label: Uniquely identifies the volume. 


volume table of contents (VTOC): A table, associated with a direct-access 
volume, that describes each data set on the volume. 


write to operator (WTO): A macro instruction that causes a message contained 
within the macro to be written to the operator's console. 


write to operation with reply (WTOR): A macro instruction that causes a message 
contained within the macro to be written to the operator's console. An operator 


reply is required. 
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other than OS indexed sequential, 
are shared 394 
when OS indexed sequential, direct- 
access data sets are Shared 395 
when resources are dedicated or 
staged 393 
data control block (see DCB) 
data event control block (see DFECB) 
data extent block (see DEB) 
data formatting subroutine 
(see subroutines) 
data set control block--format 1, 3, 4 
(see DSCB) 
data set requirements 8 
DCB (data control block) 
data area layout 414 
defined in glossary 534 
in data area directory 360 
in OS control blocks 484 
initialization 19, 51 
macro 479 
DCBD macro 479 
DDSCAN Subroutine (see subroutines) 
DEB (data extent block) 
data area layout 418 
defined in glossary 534 
in data area directory 360 
in OS control blocks 485 
DEBD macro 363 
debug statement 490 
commands 493 
examples of valid and invalid 505 
how to code 489-491 
debugging, hints for 472 
DECB (data event control block)--BISAM 
data area layout 417 
defined in glossary 534 
in data area directory 360 
in OS control blocks 486 
dedicated resources 3 
DELETE macro 479 
DEQ macro 479 
DETACH macro 479 
device sharing simulation routine (see 
IIVDVS) 
devices, dedicated 3 
DIAG 
block (see diagnostic block) 
command 503 
DIAGNOSE privileged operation 24 
diagnostic aids 471 
diagnostic block 
defined in glossary 534 
function described in IIVRCW 108-109 
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in data area directory 361 
in data area layout 424 
direct-access volume sharing 30 
data areas affected by open processing 
(JIVDVS) (figure) 33 
data areas affected by open processing 
(IIVIS) (figure) 38 
DOS sequential DASD and direct-access 
shared files 32 
flowcharts 22A-25E 256-289 
open/close processing for a sequential 
disk output file (figure) 31 
OS indexed sequential data set 
sharing 37 
OS sequential DASD and direct-access 
shared data sets 32 
processing OPEN and I/O macros for an 
OS indexed sequential data set 39 
directories 357 
data area 360-362 
Emulator macros 363-365 
Emulator module 358-359 
field names 381-389 
symbols 365-3890 
DLBL (DASD label) 
data area layout 410 
defined in glossary 534 
in data area directory 360 
DLBLD macro 363 
DOS (disk operating system) 
background communication region field 
extension Significant to the 
Emulator (figure) 475 
CE SIO 477 
communications region fields 
Significant to the Emulator 
(figure) 474 
compatibility feature 
defined in glossary 535 
function 522 
control blocks 475 
current PSW (see PSW) 
emulation 1 
Emulator dependence on 473 
Emulator entry routine (see TIVENT) 
Emulator program (se2 Emulator 
program, DOS) 
IPL (see Emulator program, DOS) 
low storage (figure) 474 
programming considerations 478 
PUB table (see also PUB) 
data area layout 459 
STO 4TT 
storage area, establishing 18, 44 
storage in Emulator region (figure) 
45 
system residence file, shared 41 
time-of-day 477 
DOSCCB macro 363 
DOSCOM macro 363 
DOSCORE macro 363 
DOSPIB macro 363 
DOSPUB macro 363 
DOSREGS macro 363 
DRILIST macro 363 
DSCB--Format 1 
data area layout 420 
defined in glossary 534 
in data area directory 361 
in OS control blocks 486 


DSCB--Format 3 
defined in glossary 534 
in data area directory 361 
in data areas 421 
DSCB--Format 4 
data area layout 421 
defined in glossary 534 
in data area directory 361 
in OS control blocks 486 
DTFD macro 363 
DTFIS ADD-~RETRVE~ADDRTR table 
data area layout 425 
defined in glossary 535 
in data area directory 361 
DTFIS load table 
data area layout 425 
defined in glossary 535 
in data area directory 361 
DTFISDST macro 363 
dumps 
interpreting 509 
snap of BEBLK (listing) 514 
snap of DOS registers and storage 
(listing) 516 
snap of Emulator I/0 control tlocks 
(listing) 513 
snap of Emulator trace table 
(listing) 514 
snap of IIVCON (listing) 512 
snap of service aids (listing) 509 


ECB (event control block) 
data area layout 434 
defined in glossary 535 
in data area directory 361 
ECB pointer table 
data area layout 435 
defined in glossary 535 
in data area directory 361 
initialization 19, 49 
EMUCONS macro 364 
(see also IIVCON) 
Emulator appendages 
abnormal end/channel end 6, 29, 484 
(see also IGG019S1) 
start I/0/end-of-extent /channel 
end/abnormal end 6, 28, 484 
(see also IGGf19SA) 
Emulator macros 363-365 
Emulator program, DOS (ITIVEMU) 
common data area (listing) 439 
control to DOS, passing 20 
data area relationships 
(figures) 393-395 
data area relationships to IIVcON 
(figure) 438 
data set requirements 8 
dependencies on OS, DOS, and 
hardware 473 
DOS storage area, establishing 
18, 44 
flowcharts 
function 1 
functional organization of 
interruption handling 
(figure) 113 


118-355 


general register assignments 517 
initialization 16 
interruption action when CPU is in 
local execution mode 21-28 
TPL, DOS 
description 20, 49, 477 
OS region at beginning of 
(figure) 50 
IPL of DOS supervisor during 
initialization (figure) 17 
main storage environment (figure) 2 
Main storage requirements 10-13 
message-to-module relationships 
518-519 
method of operation 15 
module relationship (figure) 114 
modules (see modules; directories; 
Emulator module) 
operational considerations 7 
operations, major 16 
overlay structure and load modules 
(figure) 11 
parameters, verifying 18 
physical characteristics 10 
resource requirements 2~6 
service aids 489 
tables, initializing 
communications table 
(COMTAB) 18, 44 
COMTAB extension 18, 45 
data control block (DCB) 19, 51 
ECB pointer table 19, 49 
input/output block (IOB) 20 
ISK/SSK table 19, 49 
OS PUB table 19 
post FCB list 19, 49 
EMUMSG macro 104, 364 
END command 5C4 
end-of-extent 
appendage 6, 28 
(see also IGG019SA) 
subroutines (see subroutines) 
end-of-job subroutine (see subroutines) 
end subroutine (see subroutines) 
ENQ macro 479 
EODAD subroutines (see subroutines) 
FOV macro 4890 
ESETL 
macro 480 
mapping routine (see subroutines) 
event control block (see ECB) 
EXCP macro 480 
execute local instruction 
defined in glossary 535 
function 522 
exit-ABFEND error routine (see TIVABN) 
EXIT command 501 
exit subroutine (see subroutines) 
external interruption simulation (see 
interruptions, asynchronous) 
EXTRACT macro 480 


FCB2EMC1 (see TIVFCB) 
FIDBLK macro 364 

(see also file ID block) 
field name table 381 
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file ID block (FIDBLK) 
data area layout 436 
defined in glossary 536 
in data area directory 361 
FINDADDR subroutine (see subroutines) 
FINDCHAN subroutine (see subroutines) 
FINDKEY subroutine (see subroutines) 
first program interruption 23, 55 
FIRSTPC subroutine (see subroutines) 
flowcharts 1A-34H 118-355 
abnormal end conditions (flowcharts 
26A-26B) 293-294 
asynchronous interruptions 
(flowcharts 20A-21EF) 238-251 
direct-access volume sharing 
(flowcharts 22A-25E) 256-289 
Emulator service aids (flowcharts 


28A-34H) 301-355 
initialization (flowcharts 1A-7A) 
118-160 


message writer (flowchart 27A) 297 
synchronous interruptions (flowcharts 
SA-19A) 165-234 

FMTRC macro 364 

FREEMAIN/GETMAIN routine (see ITVGET) 

FREEMAIN macro 480 

functional organization of Emulator 
interruption handling (figure) 113 


general register assignments 517 
GET 

macro 480 

mapping routine (see subroutines) 
GETMAIN/FREEMAIN routine (see IIVGET) 
GETMAIN macro 489 
GETWORD subroutine (see subroutines) 


hardware, Emulator dependence on 488 
hints for debugging 472 
HIO 
privileged operation 25 
simulation subroutine 
(see subroutines) 


I/O 
appendages (see Emulator appendages) 
device types 2 
staged (see staged input, staged 
output and staged I/0) 
IDENTIFY macro 480 
TEGO19S1 
description 29, 74 
flowchart 19A 234 
residence 28 
summary 233 


544 DOS Emulator Logic 


IGGO19SA 
description 28, 73 
flowcharts 18A-18B 231-232 
residence 28 
summary 230 
ITVABN 
description 101 
flowcharts 26A-26B 293-294 
Summary 291-292 
IIVACT 
description 108 
flowcharts 33A-33H 339-346 
Summary 338 
TIVADD 
description 51 
flowcharts 4A-4D 142-145 
Summary 141 
TIVADJ 
description 71 
flowcharts 16A-16B 226-227 
summary 225 
TIVAWV 
function 26 
description 68 
flowchart 12A 213 
summary 212 
TIVCCW 
description 69-71 
flowcharts 15A-15F 219-224 
summary 218 
TIVCHK 
description 61-62 
flowcharts 9A-9D 186-189 
summary 184-185 
IIVCON 
common data area (listing) 439-442 
fata area layout 437 
defined in glossary 536 
in data area directory 361 
relationship to other major Emulator 
data areas (figure) 438 
TIVCWV 
function 26 
descripticn 68 
flowchart 13A 215 
summary 214 
TIVDVS 
description 80-88 
flowcharts 23A-23H 262-269 
general flow (figure) 81 
summary 260-261 
ITIVEMU (see Emulator program, DOS) 
LTIVENT 
description 43 
flowchart 1A 118 
summary 117 
IIVFCB function 26 
TIVGET 
description 54 
flowchart 7A 160 
summary 159 
ITVGR2 
description 79-80 
DOS svc tables 254-255 
flowcharts 22A-22D 256-259 
summary 253 
ITIVINT 
description 43-46 
flowcharts 2A-2M 121-132 
summary 119-120 


interruptions, synchronous 
defined in glossary 539 
flowcharts 8A-19A 165-234 
program interruptions 21 
first program interruption 23 
(see also FIRSTPC subroutine) 
IPL interruption 23 
normal program interruption 23 
privileged operation 23-28 
(see also PCPRIVOP subroutine) 
supervisor call (SVC) 
interruptions 21 
(see also IIVSVC) 
interval timer interruptions (see 
interruptions, asynchronous) 
TOB (input/output block) 
data area layout 448 
defined in glossary 536 
in data area directory 361 
in OS control blocks 487 
initialization 20 
IOHALT macro 480 
IPL 
add routine (see IITVADD) 
DOS (see Emulator program, DOS) 
DOS IPL, OS region at beginning of 
(figure) 50 
ISAM 
block (see ISBLK) 
mapping of DCB fields to DTFIS field: 
after processing of each I/0 
macro 95 
mapping routine (see IIVIS) 
mapping subroutines (see subroutines) 
storage estimates table 12 
ISBLK 
data area layout 450 
defined in glossary 536 
in data area directory 361 
macro 364 
ISK 
privileged operation 24 
Simulation subroutine 
(see subroutines) 
ISK/SSK (insert storage key/set storage 
key) table 
data area layout 452 
defined in glossary 536 
in data area directory 361 
initialization 19 


JFCB (job file control block) 
data area layout 452 
defined in glossary 536 
in data area directory 361 
in OS control blocks 487 


LCTL privileged operation 24 
load control instruction (see LCTL) 


load control register subroutine 
(see subroutines) 
load FCB subroutine (see subroutines) 
LOAD macro 481 
load open mapping subroutine (see 
subroutines) 
local addresses 1 
local execution 
list (see also execute local 
instruction) 
data area layout 454 
defined in glossary 536 
in data area directory 361 
mode (see mode, local execution) 
PSW (see PS¥W) 
LOGOUT! subroutine (see subroutines) 
LOGOUT2 subroutine (see subroutines) 
LPSW 
privileged operation 24 
Simulation subroutine 
(see subroutines) 
LUB (logical unit block) 
data area layout 457 
defined in glossary 537 
in data area directory 361 
in DOS control blocks 476 


macro instructions 
Emulator 363-365 
OS 479-483 
Main storage requirements 10-13 
Main task control executive routine 
(see subroutines) 
message-to-module relationships 518-519 
message writer routine (see IIVMSG) 
MGTXT macro 105, 364 
mode 
local execution 
defined in glossary 537 
described 1, 522 
normal 
defined in glossary +537 
described 1 
modules 
(see also IGGxxxxx; TIVxxx) 
defined in glossary 537 
directory of Emulator modules 
(table) 358-359 
functional organization of Emulator 
interruption handling (figure) 11 
relationship (figure) 114 
MSGCODT macro 106, 364 


nornal 
mode (see mode, normal) 
program interruption 21 
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OBTAIN 
macro 481 
routine (see subroutines) 
OBTNWK macro 364 
OPEN 
macro 481 
mapping routine (see subroutines) 
routine (see IIVOPN) 
subroutine (see subroutines) 
Subroutine gross flow (figure) 52 
table 
data area layout 458 
defined in glossary 537 
in data area directory 362 
TYPE=J macro 481 
OPENFAIL routine (see subroutines) 
OPEN60 subroutine (see subroutines) 
Os 
access methods 483 
appendages 484 
bypass label processing 7 
control blocks 484-488 
Emulator dependence on 478-488 
macros 479-483 
PUB table 
build routine (see TIIVPUB) 
data area layout 459 
defined in glossary 537 
in data area directory 362 
initialization 19 
output, staged (see staged output) 


parameters, verifying (see Emulator 
program, DOS) 
PCPRIVOP subroutine (see subroutines) 
physical unit block (see PUB) 
PIB (program information block) 
data area layout 460 
defined in glossary 537 
in data area directory 362 
in DOS control blocks 476 
post ECB list 
data area layout 460 
defined in glossary 537 
in data area directory 362 
initialization 19 
POST macro 481 
printer overflow 
routine (see TIVPOV) 
Simulation 7 
privileged operations 23-28 
program 
addresses 1 
check executive routine (see IIVPCE) 
check intercept routine (see IIVPCT) 
information block (see PIB) 
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interruptions (see interruptions, 
synchronous) 
status word (see PSW®) 
prompt reply processor routine 


(see IIVPRP) 
PRPMAPA subroutine (see subroutines) ) 
PRPMAP1 subroutine (see subroutines) 
PSW (program status word) 

data area layout 461 

defined in glossary 538 

explanation of local execution (DOS 

current) PSW 21 
function of local execution (DOS 
current) PSW (figure) 22 

in data area directory 362 
PUB (physical unit block) 

data area layout 458 

defined in glossary 537 

in data area directory 362 

in DOS control blocks 476 
PUT 

Macro 482 

mapping routine (see subroutines) 
PUTX macro 482 


QSAM storage estimates table 13 


RASCONS macro 365 J 


(see also TIVRCN) 


RCPPRINT subroutine (see 
RDD privileged operation 
RDJFCB macro 482 

read FCB subroutine (see 


subroutines) 
24 


subroutines) 


READ KEY mapping routine 
(see subroutines) 
READ KU macro 482 
register assignments 517 
relationship of IIVCON to other 
data areas (figure) 438 
relationship of IIVRCN to other service 
aids modules, other Emulator modules, 
IIVCON, and user routines 
(figure) 444 
resources 
dedicated 3 
definition 2 
Shared 4 
staged 4 
restore DEB extent subroutine (see 
subroutines) 
RETURN macro 482 
return routine (see subroutines) 
route routine (see subroutines) 
routine descriptions, Emulator 43 


SAVE macro 482 
SCAN subroutine (see subroutines) 
SCK privileged operation 24 
SEEKDVS subroutine (see subroutines) 
SEEKTEST subroutine (see subroutines) 
select subroutine (see subroutines) 
service aids 
control flow (figure) 5(2 
description 489 
examples of usage to diagnose 
problems 506-509 
flowcharts 28A-34H 301-355 
use of 489-490 
set clock (see SCK) 
set clock subroutine (see subroutines) 
SETL 
macro 482 
mapping routine (See subroutines) 
shared system residence file, DOS 41 
STO 
appendage 6, 28 
(see also IGG019SA) 
CE 477 
DASD subroutine (see subroutines) 
DOS 477 
privileged operation 25-28 
subroutine (see subroutines) 
tape subroutine (see subroutines) 
snap 
dump and trace formatting routine 
(see TIVSNP) 
subroutine (see subroutines) 
SNAP 
command 498 
macro 482 
SSK 
privileged operation 24 
Simulation subroutine 
(see subroutines) 
SSM 
privileged operation 24 
Simulation subroutine 
(see subroutines) 
STAE 
macro 482 
retry routine (see subroutines) 
routine (see subroutines) 
staged I/0 
constants block (see STGCON) 
control program flow (figure) 27 
defined in glossary 538 
routine (see TIVSTG) 
staged input 
definition 4 
description 65 
staged output 
definition 4 
description 65 
output considerations 7 
printer overflow simulation 7 
separator feature 8 
start I/O (see SIO) 


status mapping routine (see subroutines) 


status modifier table 70 
STCTL privileged operation 24 
3TGCON (staged I/O constants block) 
data area layout 463 
defined in glossary 538 


in data area directory 362 
STGTAB macro 365 
STIDC privileged operation 24 
STIDP privileged operation 24 
STIMER macro 483 
storage 
DOS, in Emulator region (figure) 45 
for Emulator data sets’ 10 
for files on shared devices 12 
for indexed sequential data sets 12 
for service aids 13 
main, requirements 10-13 
subroutine (see subroutines) 
STORAGE command 500 
store channel ID instruction (see STIDC) 
store clock subroutine (see subroutines) 
store control instruction (see STCTL) 
store control register subroutine 
(see subroutines) 
store CPU ID instruction (see STIDP) 
store CPU ITD subroutine (see subroutines 
subroutines 
abnormal end (DASD) (IGG019SA) 
description 74 
flowchart 18B 232 
ADD, RETRVE, ADDRTR open mapping 
(IIVIS) 
description 90 
flowchart 248 273 
source of input to supported DTFIS 
fields at open of ADD, RETRVE, 
and ADDRTR 90 
ASKOPR (IIVINT) 
description 46 
flowchart 2L = 131 
asynchronous intercept 
initialization (IIVRAS) 
description 105 
flowcharts 28B 302 
asynchronous interrupt check (IIVRTE) 
description 77 
flowcharts 20F-20F 242-243 
build DLBL (IIVDVS) 
description 88 
flowchart 23H 269 
channel end (DASD) (IGGOT9SA) 
description 74 
flowchart 18B 232 
CHKCUU (TIVINT) 
description 46 
flowchart 2L 131 
close (IIVDVS) 
description 86 
flowchart 23E 266 
close mapping (IIVTS) 
description 91 
flowchart 24C 274 
combine (IIVCCW) 
_ description 71 
flowchart 15F 224 
combine (ITVRCW), flowchart 34H 355 
COMBO4UA (TIVCCW), flowchart 15F 224 
COMBOSA (ITVRCW), flowchart 34H 355 
control (IIVDVS) 
description 82 
flowchart 23A 262 
CVT (TIVRCP), flowchart 29D 310 
data formatting (IIVSNP) 
description 106 
flowchart 303 330 
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DDSCAN (TIVINT) 
description 46 
flowchart 2M 132 
diagnostic (IIVRCP), flowchart 29L 
317 
EBCDIC conversion 
description 106 
flowchart 30G 328 
end (IIVRCP), flowchart 29N-29P 
319-320 
end-of-extent (IGG019SA) 
description 73 
flowchart 18A 231 
end-of-extent {IIVDVS) 
description 84 
flowcharts 23C-23D 264-265 
end-of-job (IIVRTE) 
description 77 
flowchart 20G 244 
EODAD (IIVIS), flowchart 24L 282 
EODAD (IiVSTG) 
description 67 
flowchart 11N 211 
ESETL mapping (TIVIS) 
description 92 
flowchart 24G 278 
exit (TIVRCP), flowchart 29M 318 
FINDADDR (IIVPCE) 
description 60 
flowchart 8R 180 
FINDCHAN (IIVPCE) 
description 59 
flowchart 8Q 179 
FINDKEY (IIVPCE) 
description 60 
flowchart 8S _ 181 
FIRSTPC (TIVPCE) 
description 55 
flowchart 8A 165 
GET mapping (IIVIS) 
description 92 
flowchart 24F 277 
GETWORD (IIVRCP), flowchart 29C 309 
HIO simulation (IIVPCE) 
description 58 
flowchart 8H 172 
IIVLOGR1 (TIVLOG) 
description 63 


flowchart 10C 194 
IIVLOGR2 (IIVLOG) 


description 63 
flowchart 10E 196 
TIVRASPC (IIVRAS) 
description 104 
flowchart 28B 302 
TIVRASVC (IIVRAS) 
description 105 
flowchart 28B 302 
TIVRASYN (IIVRAS) 
description 105 
flowchart 28B 302 
ISK simulation (IIVPCE) 
description 56 
flowchart 8C 167 
load FCB (I1IVSTG) 
description 67 
flowchart 11M 210 
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load open mapping (IIVIS) 
description 89 
flowchart 24B 273 
sources of input to DCB fields at 
OS indexed sequential data set | 
creation 89 
load/store control register (IIVPCE) 
description 60 
flowchart 8T 182 
LOGOUT1 (IIVLOG), flowchart 10D 195 
LOGOUT2 (IIVLOG), flowchart 10D 195 
LPSW simulation (TIVPCE) 
description 56 
flowchart 8D 168 
main task control executive 
routine (IIVIS) 
description 88 
flowchart 24A 272 
OBTAIN (TIVDVS) 
description 87 
flowcharts 23F-23G 267-268 
OPEN (IIVDVS) 
description 83 
flowcharts 23A-23B 262-2€3 
OPEN mapping (TIVIS) 
description 89 
flowchart 24B 273 
OPENFAIL (IIVIS) 
description 94 
flowchart 24L 282 
OPEN60 (IIVOPN), flowchart 5D 151 
PCPRIVOP (IIVPCE) 
description 55 
flowchart 8A 165 
program check intercept (IIVPCTI) 
description 107 ; 
flowchart 31A-31C 233-335 
program check intercept 
initialization (IIVRAS) 
description 104 
flowchart 28B 302 
PRPMAPA (IIVPRP), flowchart 21E 251 
PRPMAP1 (IIVPRP), flowchart 21E= 251 
PUT mapping (IIVIS) 
description 92 
flowchart 24G 278 
RCPPRINT (IIVRCP), flowchart 29D 31C 
read FCB (IIVSTG) 
description 66 
flowchart 11L 209 
read key mapping (IIVIS) 
description 93 
flowchart 24H 279 
restore DEB extent (1GG019SA) 
description 74 
flowchart 18B 232 
return (TIVDVS) 
description 88 
flowchart 23H 269 
route (IIVRTE) 
description 75 
flowchart 20B 239 
SCAN (ITIVINT) 
description 46 
flowchart 2K 130 
SEEKDVS (IIVPCE) 


description 59 
flowchart 8P 178 ) 


.. 


subroutines (continued) 
SEEKTEST (IIVPCE) 
description 59 
flowchart 8K 174 
select (TIVRTE) 
description 76 
flowchart 20C 24°f 
set clock (IIVPCE) 
description 61 
flowchart 8U 183 
SETL mapping (IIVIS) 
description 91 
flowchart 24D 275 
SIO (IIVPCE) 
description 58 
flowcharts 8J-8N 173-177 
SIO (DASD) (IGG019SA) 
description 73 
flowchart 18B 232 
SIO (tape) (IGGO19SA) 
description 73 
flowchart 18A 231 
snap (TIVRCP), flowcharts 29G6-29J 
313-315 
snap (IIVSNP) 
description 106 
flowchart 39K 331 
SSK Simulation (IIVPCE) 
description 56 
flowchart 8C 167 
SSM simulation (IIVPCE) 
description 56 
flowchart 8C 167 
STAE exit (IIVPTE) 
description 75 
flowchart 20A 238 
STAE retry (IIVRTE) 
description 76 
flowchart 20C 240 
status mapping (IIvVISs) 
description 94 
flowchart 24L 282 
storage (TIVRCP), flowchart 29K 
store clock (IIVPCE£) 
description 61 
flowchart 80 183 
store control register (IIVPCE) 
description 60 
flowchart 8T 182 
store CPU ID (TIVPCE) 
description 69 
flowchart 8S _ 181 
subtask attaching (IIVIS) 
description 90 
flowchart 24B 273 
subtask control executive routine 
(IIVIS) 
description 91 
flowchart 24E 276 
supervisor call intercept 
initialization (IIVRAS) 
description 105 
flowchart 28B 302 
SvC 50 (IIVIS) 
description 94 
flowchart 24L 282 
SYNAD (IIvtIsS) 
description 94 
flowchart 24L 282 


3 


SYNAD (IIVSTG) 
description 67 
flowchart 11N 211 

TCH Simulation (IIVPCE) 
description 57 
flowchart 8E 169 

timer interruption (IIVRTE) 
description 77 
flowchart 20D 241 

timer interruption check (IIVRTE) 
description 77 
flowchart 20D 241 

TIO simulation (TIVPCE) 
description 57 
flowcharts 8F-8G 170-171 

trace (IIVRCP), flowcharts 29F-29F 
311-312 

trace table (TIVSNP) 
description 105 
flowcharts 30E-30G 326-328 

VIOA (ITVVIO) 
description 96 
flowchart 25A 285 

VIOB (IIVVIO) 
description 97 
flowchart 25B 286 

VIOc (IIVVIO}) 
description 97 
flowchart 25B 286 

VIOD (TIVVIO) 
description 97 
flowchart 25B 286 

VIOE (IIVVIO) 
description 97 
flowchart 25B 286 

VIOERRX (IIVVIO) 
description 109 
flowchart 25E 289 

VIOF (IIVVIO) 
description 97 
flowchart 25B 286 

VIOG (IIVVIO) 
description 97 
flowchart 25C 287 

VIOH (IIVVTIO) 
description 97 
flowchart 25C 287 

VIOI (IIVVIO) 
description 98 
flowchart 25C 287 

VIOIO (IIVVTO) 
description 99 
flowchart 25C 287 

VIOIOA (IIVVIO) 
description 99 
flowchart 25D 288 

VIOIOB (IIVVIO) 
description 100 
flowchart 25D 288 

VIoIoc (IIVVIO) 
description 100 
flowchart 25D 288 

VIOIOD (IIVVIO) 
description 100 
flowchart 25D 288 

VIOIOE (IIVVIO) 
description 100 
flowchart 25E 289 
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subroutines (continued) 
VIOIOF (IIVVIO) 
description 109 
flowchart 25F 289 
VIOIOSIM (IIVVIO) 
description 100 
flowchart 25E 289 
vIog (IIVVIO) 
description 98 
flowchart 25C 287 
VIONXT (TIVVIO) 
description 98 
flowchart 25C 287 
WAITF mapping (IIVTS) 
description 93 
flowchart 24K 281 
write (IIVSNP) 
description 106 
flowcharts 30H-30J3 329-330 
write key mapping (TIIVIS) 
description 93 
flowchart 24H 279 
write NEWKEY mapping (IIVIS) 
description 93 
flowchart 243 280 
YFSORNO (IIVINT) 
description 46 
flowchart 2K 130 
subtask attaching routine 
(see subroutines) 
subtask control routine (see subroutines 
supervisor call (SVC) 
intercept initialization routine (see 
IIVRASVC) 
intercept routine (see IIVSCT) 
interruptions 21 
monitor routine (see IIVGR2) 
routine (see IIVSVC) 
svc 50 routine (see subroutines) 
symbol table 366-380 
SYNAD subroutines (see subroutines) 
synchronous interruptions (see 
" interruptions, synchronous) 
system residence file, shared 
for DOS 41 
System/370 machine interruption logic 
(figure) 22 


tape error block (see TEB) 
tape error by volume (see TEBV) 
task control block (see TCB) 
task input/output table (see TIOT) 
TCH 
privileged operation 24 
simulation subroutine 
(see subroutines) 
TEB (tape error block) 
data area layout 465 
defined in glossary 539 
in data area directory 362 
in DOS control blocks 476 
TEBV (tape error by volume) 
data area layout 466 
defined in glossary 539 
in data area directory 362 
in DOS control blocks 476 
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TIM™ macro 483 
time-of-day, DOS 477 
timer interruption 

check subroutine (see subroutines) 

subroutine (see subroutines) J 
TIO 
privileged operation 24-25 
Simulation subroutine 

(see subroutines) 
TIOT (task input/output table) 

data area layout 467 

defined in glossary 539 

in data area directory 362 

in OS control blocks 488 
trace 

subroutine (see subroutines) 

table 

how to locate (figure) 496 
internal format (table) 497 

TRACE command 493 
TRCDSCT macro 365 
true addresses (see program addresses) 


UCB (unit control block) 
data area layout 468 
defined in glossary 539 
in data area directory 362 
in OS control blocks 488 


VIO routires (see subroutines) 
volume label 
data area layout 469 
defined in glossary 539 
in data area directory 362 
VTOC I/O simulation routine (see IIVVIO) 


WAIT macro 483 
WAITF mapping routine (see subroutines) 
WRD privileged operation 24 
WRITE K, KN macros 483 
WRITE KFY mapping routine 
(see subroutines) 
WRITE macro 483 
WRITE NEWKEY mapping routine (see 
subroutines) 
WTO macro 483 
WTOR macro 483 


) 


YESORNO subroutine (see subroutines) 


WTO macro 481 
WTOR macro 4874 


1( sacro 481 
WA mapping routine (see subroutines) 


WRD privileged operation 28 

WRITE K, KN macros 481 

WRITE KEY mapping routine (see subroutines) 

WRITE macro 481 

WRITE NEWKEY mapping routine (see 
subroutines) 


YESORNO subroutine (see subroutines) 


Index 
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